setClipboard

Set the device clipboard content to a specified text value.

The setClipboard command sets a specified text string to Maestro's in-memory clipboard. It allows you to define the clipboard content directly, unlike copyTextFrom which copies text from a UI element.

Syntax

The setClipboard command accepts a string or a JavaScript expression:

- setClipboard: "[email protected]"  # string
- setClipboard: "${'user' + Math.floor(Math.random() * 1000) + '@example.com'}" # JavaScript expression

Usage examples

Set a static value

This example sets a static email address to the clipboard and then pastes it into a text field instead of typing. Using pasteText can help avoid flakiness when entering text.

appId: com.example.app
---
- launchApp
- tapOn:
    id: "emailField"
- setClipboard: "[email protected]"
- pasteText

Set a dynamic value

You can use a JavaScript expression to generate dynamic content for the clipboard.

appId: com.example.app
---
- launchApp
- setClipboard: ${'user' + Math.floor(Math.random() * 1000) + '@example.com'}
- tapOn:
    id: "emailField"
- pasteText

Access clipboard contents

You can access the clipboard's contents in subsequent steps using the maestro.copiedText property.

appId: com.example.app
---
- setClipboard: "[email protected]"
- inputText: ${'Email: ' + maestro.copiedText}

Related commands

• pasteText

• copyTextFrom