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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.