База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Clipboard.write — асинхронно записване в клипборда

Clipboard.write записва обекти ClipboardItem в системния клипборд. Приема алтернативни MIME представяния, но изисква защитен контекст и разрешение от браузъра.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

await navigator.clipboard.write([new ClipboardItem({ "text/plain": new Blob([text], { type: "text/plain" }) })]);

Clipboard.write, извикана като navigator.clipboard.write(items), приема обекти ClipboardItem. Един елемент може да съдържа няколко MIME представяния на едно и също съдържание. writeText(text) е по-лесна за работа, когато става дума само за текст. Върнатото обещание се изпълнява със стойност undefined след записването; отказаният достъп може да доведе до NotAllowedError.

Това е Web API, а не част от ECMAScript; Node 24 не доказва поддръжка в браузърите. Проверете дали API е налично и тествайте целевите браузъри. Използвайте защитен контекст: HTTPS или надежден локален произход, например localhost. Само HTTPS не гарантира защитен контекст, когато страницата е вградена под незащитен предшественик; проверете window.isSecureContext.

Извършвайте записването непосредствено след щракване в активен документ и обработвайте грешките; правилата за разрешения се различават според браузъра. Не бъркайте няколко представяния с няколко елемента: платформата може да запази само първия елемент. Примерът заменя съдържанието на клипборда след съзнателно щракване от потребителя.

Примери

<!doctype html>
<meta charset="utf-8">
<title>Clipboard.write</title>
<button id="copy" type="button">Copy: Hello, clipboard!</button>
<output id="status" aria-live="polite"></output>
<script>
const button = document.querySelector('#copy');
const status = document.querySelector('#status');

button.addEventListener('click', async () => {
  if (!window.isSecureContext ||
      typeof navigator.clipboard?.write !== 'function' ||
      typeof ClipboardItem !== 'function') {
    status.textContent = 'Unavailable';
    return;
  }

  try {
    const blob = new Blob(['Hello, clipboard!'], { type: 'text/plain' });
    const item = new ClipboardItem({ 'text/plain': blob });
    await navigator.clipboard.write([item]);
    status.textContent = 'Copied';
  } catch (error) {
    status.textContent = `Failed: ${error.name}`;
  }
});
</script>

Резултат

The status is initially empty. After the user clicks the button, it displays `Copied` only if the clipboard write succeeds. If the context is insecure or the required API is unavailable, it displays `Unavailable`. If an error occurs while preparing or writing the clipboard item, it displays `Failed: ` followed by the error name.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници