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

CKTIS / JavaScript

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

Clipboard.writeText записва обикновен текст в системния клипборд. Операцията е асинхронна и изисква защитен контекст и разрешение от браузъра за запис.

Версия: 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.writeText(text);

Clipboard.writeText, извикан като navigator.clipboard.writeText(text), заменя съдържанието на клипборда с обикновен текст, а не с HTML. Връща Promise, която след записването се изпълнява със стойност undefined.

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

Използвайте await и try...catch; съобщавайте за успех едва след изпълнението на promise. Проверете наличността на API в целевия браузър: Node 24 в хранилището не доказва поддръжка в браузърите.

Примери

const button = document.createElement('button');
button.type = 'button';
button.textContent = 'Copy CKTIS';
const status = document.createElement('p');
status.setAttribute('role', 'status');
document.body.append(button, status);

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

  try {
    await navigator.clipboard.writeText('CKTIS');
    status.textContent = 'Copied: CKTIS';
  } catch (error) {
    status.textContent = `Copy failed: ${error.name}`;
  }
});

Резултат

Copied: CKTIS

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

Източници