electron/docs/api/clipboard.md

clipboard

Perform copy and paste operations on the system clipboard.

The following example shows how to write a string to the clipboard:

const {clipboard} = require('electron')
clipboard.writeText('Example String')

On X Window systems, there is also a selection clipboard. To manipulate it you need to pass selection to each method:

const {clipboard} = require('electron')
clipboard.writeText('Example String', 'selection')
console.log(clipboard.readText('selection'))

Methods

The clipboard module has the following methods:

Note: Experimental APIs are marked as such and could be removed in future.

clipboard.readText([type])

• type String (optional)

Returns the content in the clipboard as plain text.

clipboard.writeText(text[, type])

• text String
• type String (optional)

Writes the text into the clipboard as plain text.

clipboard.readHTML([type])

• type String (optional)

Returns the content in the clipboard as markup.

clipboard.writeHTML(markup[, type])

• markup String
• type String (optional)

Writes markup to the clipboard.

clipboard.readImage([type])

• type String (optional)

Returns the content in the clipboard as a NativeImage.

clipboard.writeImage(image[, type])

• image NativeImage
• type String (optional)

Writes image to the clipboard.

clipboard.readRTF([type])

• type String (optional)

Returns the content in the clipboard as RTF.

clipboard.writeRTF(text[, type])

• text String
• type String (optional)

Writes the text into the clipboard in RTF.

clipboard.readBookmark() macOS Windows

Returns an Object containing title and url keys representing the bookmark in the clipboard. The title and url values will be empty strings when the bookmark is unavailable.

clipboard.writeBookmark(title, url[, type]) macOS Windows

• title String
• url String
• type String (optional)

Writes the title and url into the clipboard as a bookmark.

clipboard.clear([type])

• type String (optional)

Clears the clipboard content.

clipboard.availableFormats([type])

• type String (optional)

Returns an array of supported formats for the clipboard type.

clipboard.has(data[, type]) Experimental

• data String
• type String (optional)

Returns whether the clipboard supports the format of specified data.

const {clipboard} = require('electron')
console.log(clipboard.has('<p>selection</p>'))

clipboard.read(data[, type]) Experimental

• data String
• type String (optional)

Reads data from the clipboard.

clipboard.write(data[, type])

• data Object
  • text String
  • html String
  • image NativeImage
  • rtf String
  • bookmark String - The title of the url at text.
• type String (optional)

const {clipboard} = require('electron')
clipboard.write({text: 'test', html: '<b>test</b>'})

Writes data to the clipboard.