Skip to main content
Version: v5

@capacitor/clipboard

The Clipboard API enables copy and pasting to/from the system clipboard.

Installโ€‹

npm install @capacitor/clipboard
npx cap sync

Exampleโ€‹

import { Clipboard } from '@capacitor/clipboard';

const writeToClipboard = async () => {
await Clipboard.write({
string: "Hello World!"
});
};

const checkClipboard = async () => {
const { type, value } = await Clipboard.read();

console.log(`Got ${type} from clipboard: ${value}`);
};

APIโ€‹

write(...)โ€‹

write(options: WriteOptions) => Promise<void>

Write a value to the clipboard (the "copy" action)

ParamType
options
WriteOptions

Since: 1.0.0


read()โ€‹

read() => Promise<ReadResult>

Read a value from the clipboard (the "paste" action)

Returns:

Promise<ReadResult>

Since: 1.0.0


Interfacesโ€‹

WriteOptionsโ€‹

Represents the data to be written to the clipboard.

PropTypeDescriptionSince
stringstringText value to copy.1.0.0
imagestringImage in Data URL format to copy.1.0.0
urlstringURL string to copy.1.0.0
labelstringUser visible label to accompany the copied data (Android Only).1.0.0

ReadResultโ€‹

Represents the data read from the clipboard.

PropTypeDescriptionSince
valuestringData read from the clipboard.1.0.0
typestringType of data in the clipboard.1.0.0