2013-09-09 11:35:57 +04:00
|
|
|
# clipboard
|
2013-08-15 02:43:35 +04:00
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
The `clipboard` provides methods to do copy/paste operations. An example of
|
|
|
|
writing a string to clipboard:
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
```javascript
|
|
|
|
var clipboard = require('clipboard');
|
|
|
|
clipboard.writeText('Example String');
|
|
|
|
```
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
On X Window systems, there is also a selection clipboard, to manipulate in it
|
|
|
|
you need to pass `selection` to each method:
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
var clipboard = require('clipboard');
|
|
|
|
clipboard.writeText('Example String', 'selection');
|
|
|
|
console.log(clipboard.readText('selection'));
|
|
|
|
```
|
|
|
|
|
|
|
|
## clipboard.readText([type])
|
|
|
|
|
|
|
|
* `type` String
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
Returns the content in clipboard as plain text.
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
## clipboard.writeText(text[, type])
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
* `text` String
|
2014-06-05 10:48:12 +04:00
|
|
|
* `type` String
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
Writes the `text` into clipboard as plain text.
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
## clipboard.clear([type])
|
|
|
|
|
|
|
|
* `type` String
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
Clears everything in clipboard.
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
## clipboard.has(format[, type])
|
2013-08-15 02:43:35 +04:00
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
* `format` String
|
2013-08-15 02:43:35 +04:00
|
|
|
* `type` String
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
Returns whether clipboard has data in specified `format`.
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
**Note:** This API is experimental and could be removed in future.
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
## clipboard.read(format[, type])
|
2013-08-15 02:43:35 +04:00
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
* `format` String
|
2013-08-15 02:43:35 +04:00
|
|
|
* `type` String
|
|
|
|
|
2014-06-05 10:48:12 +04:00
|
|
|
Reads the data in clipboard of the `format`.
|
2013-08-15 02:43:35 +04:00
|
|
|
|
|
|
|
**Note:** This API is experimental and could be removed in future.
|