ClipboardItem: getType() メソッド
Baseline 2024
最近利用可能
2024年6月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
getType() は ClipboardItem インターフェイスのメソッドで、要求された MIME タイプ の Blob で解決するプロミス (Promise) を返します。MIME タイプが見つからない場合はエラーになります。
構文
js
getType(type)
引数
返値
例外
NotFoundErrorDOMException-
typeが既知の MIME タイプに一致しない。 TypeError-
引数が指定されなかった、または
typeがClipboardItemのものではない。
例
次の例では、 clipboard.read() メソッドによってクリップボード上のすべてのアイテムを返しています。そして、 ClipboardItem.types プロパティを利用して getType() 引数をセットし、対応する blob オブジェクトを返します。
js
async function getClipboardContents() {
try {
const clipboardItems = await navigator.clipboard.read();
for (const clipboardItem of clipboardItems) {
for (const type of clipboardItem.types) {
const blob = await clipboardItem.getType(type);
// ここで blob を使用することができます
}
}
} catch (err) {
console.error(err.name, err.message);
}
}
仕様書
| 仕様書 |
|---|
| Clipboard API and events # dom-clipboarditem-gettype |