CKTIS / JavaScript
Clipboard — асинхронен достъп до клипборда
Clipboard предоставя достъп до системния клипборд чрез navigator.clipboard; операциите са асинхронни и подлежат на ограничения за сигурност.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>Clipboard, достъпен чрез navigator.clipboard, е интерфейс на Web API, а не на ECMAScript. readText() връща текст, writeText() записва текст; read() и write() обработват обекти ClipboardItem. Методите връщат обещания.
Необходими са защитен контекст и фокус върху документа. Разрешенията и активирането от потребителя могат да ограничат достъпа; щракването не гарантира успех. Обработвайте отхвърлените обещания, включително NotAllowedError. Проверявайте наличните функции; проектът на W3C не гарантира поддръжка от браузърите, а Node 24 също не я доказва.
Това се различава от синхронните събития copy, cut и paste, които използват event.clipboardData. Клипбордът може да съдържа тайни: избягвайте четенето му без заявка. Примерът заменя съдържанието на клипборда едва след щракване.
Примери
const button = document.createElement('button');
const status = document.createElement('p');
button.textContent = 'Copy CKTIS';
status.setAttribute('role', 'status');
document.body.append(button, status);
button.addEventListener('click', async () => {
if (!window.isSecureContext ||
typeof navigator.clipboard?.writeText !== 'function') {
status.textContent = 'Clipboard unavailable';
return;
}
button.disabled = true;
try {
await navigator.clipboard.writeText('CKTIS');
status.textContent = 'Copied: CKTIS';
} catch (error) {
status.textContent = `Copy failed: ${error.name}`;
} finally {
button.disabled = false;
}
});Резултат
On an allowed, successful click: Copied: CKTIS Clipboard text: CKTIS
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.