# clipboard（クリップボード）
{% hint style="info" %}
ヒント：開発デバッグには、Clipboard Viewer（[Win](https://freeclipboardviewer.com/) / [Mac](https://langui.net/clipboard-viewer/)）ツールの使用がお勧めです。これにより、開発プロセスがスムーズになります。
{% endhint %}
```javascript
await eagle.clipboard.writeText('Example string');
console.log(await eagle.clipboard.readText());
```
***
### メソッド
## clear()
クリップボードの内容をクリアします。
```javascript
eagle.clipboard.writeText('Example string');
eagle.clipboard.clear();
console.log(eagle.clipboard.readText()); // undefined
```
***
## has(format)
現在のクリップボードの内容に指定したフォーマットが含まれているかどうかを確認します。
* `format` string - 指定された形式
* 戻り値 boolean - 指定された形式が含まれているかどうか
```javascript
console.log(eagle.clipboard.has('public/utf8-plain-text')); // false
const buffer = Buffer.from('writeBuffer', 'utf8');
eagle.clipboard.writeBuffer('public/utf8-plain-text', buffer);
console.log(eagle.clipboard.has('public/utf8-plain-text')); // true
```
***
## writeText(text)
`text`をプレーンテキストとしてクリップボードに書き込みます。
* `text` string - 書き込むテキスト
```javascript
eagle.clipboard.writeText('Example string');
console.log(eagle.clipboard.readText()); // 'Example string'
```
***
## readText()
現在のクリップボードからプレーンテキストを取得します。
* 戻り値 string
```javascript
console.log(await eagle.clipboard.readText());
```
***
## writeBuffer(format, buffer)
`buffer`を`format`タイプとしてクリップボードに書き込みます。
* `format` string - クリップボード形式
* `buffer` Buffer - 書き込むBufferフォーマットの内容
```javascript
const buffer = Buffer.from('writeBuffer', 'utf8');
eagle.clipboard.writeBuffer('public/utf8-plain-text', buffer);
```
***
## readBuffer(format)
クリップボードから`format`タイプの内容を読み込みます。
* 戻り値 Buffer
```javascript
const buffer = Buffer.from('this is binary', 'utf8');
eagle.clipboard.writeBuffer('public/utf8-plain-text', buffer);
const out = eagle.clipboard.readBuffer('public/utf8-plain-text');
console.log(buffer.equals(out)); // true
```
***
## writeImage(image)
`image`をクリップボードに書き込みます。
* `image` [NativeImage](https://www.electronjs.org/zh/docs/latest/api/native-image) - クリップボードに書き込む画像
```javascript
let img = nativeImage.createFromPath('path_to_img_file');
eagle.clipboard.writeImage(img);
```
***
## readImage()
クリップボードから画像形式のコンテンツを読み取ります。
* 返り値 [NativeImage](https://www.electronjs.org/zh/docs/latest/api/native-image)
```javascript
let input = nativeImage.createFromPath('path_to_img_file');
eagle.clipboard.writeImage(input);
let output = eagle.clipboard.readImage();
```
***
## writeHTML(markup)
`markup` を HTML 形式でクリップボードに書き込みます。
* `markup` 文字列
```javascript
eagle.clipboard.writeHTML('Hi');
console.log(eagle.clipboard.readHTML()); // Hi
```
***
## readHTML()
クリップボードから HTML 形式のコンテンツを読み取ります。
* 返り値 文字列
```javascript
eagle.clipboard.writeHTML('Hi');
console.log(eagle.clipboard.readHTML()); // Hi
```
***
## copyFiles(paths)
指定されたファイルをクリップボードにコピーし、ファイルマネージャで貼り付けが可能です。
* `paths` 文字列の配列 - クリップボードにコピーするファイルのパス。
```javascript
eagle.clipboard.copyFiles([
'path_to_file',
'path_to_file2'
]);
```
***
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.eagle.cool/plugin-api/ja-jp/api/clipboard.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.