Буфер обмена: метод writeText()

Защищённый контекст: Эта функция доступна только в защищённых контекстах (HTTPS), в некоторых или всех поддерживающих браузерах.

Метод writeText() интерфейса Clipboard записывает указанный текст в буфер обмена системы, возвращая Promise, который разрешается после обновления буфера обмена системы.

Синтаксис

writeText(newClipText)

Параметры

newClipText: Строка, которая должна быть записана в буфер обмена.

Возвращаемое значение

A Promise, который разрешается после обновления содержимого буфера обмена.

Исключения

NotAllowedError DOMException: Выбрасывается, если запись в буфер обмена запрещена.

Соображения безопасности

Запись в буфер обмена может выполняться только в защищённом контексте.

Дополнительные требования безопасности описаны в разделе «Соображения безопасности» в теме обзора API Безопасность.

Примеры

В этом примере содержимое буфера обмена устанавливается в строку "<пустой буфер обмена>".

button.addEventListener("click", () => writeClipboardText("<empty clipboard>"));

async function writeClipboardText(text) {
  try {
    await navigator.clipboard.writeText(text);
  } catch (error) {
    console.error(error.message);
  }
}

Спецификации

Спецификация
API буфера обмена и события # dom-clipboard-writetext

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`writeText`	66 ["С версии 107 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 107 пользователь должен предоставить разрешение `clipboard-write`."]	79 ["С версии 107 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 107 пользователь должен предоставить разрешение `clipboard-write`."]	63 ["Этот метод должен вызываться внутри обработчиков событий пользовательских жестов.", "Для веб-расширений требуется разрешение `clipboardRead` в манифесте для чтения данных. С этим разрешением расширение не требует пользовательского взаимодействия и не отображает запрос на вставку.", "Запрос на вставку отображается при чтении буфера обмена. Если буфер обмена содержит данные из того же происхождения, запрос подавляется."]	53 ["С версии 93 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 93 пользователь должен предоставить разрешение `clipboard-write`."]	13.1 Этот метод должен вызываться внутри обработчиков событий пользовательских жестов.	66 ["С версии 107 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 107 пользователь должен предоставить разрешение `clipboard-write`."]	63 ["Этот метод должен вызываться внутри обработчиков событий пользовательских жестов.", "Для веб-расширений требуется разрешение `clipboardRead` в манифесте для чтения данных. С этим разрешением расширение не требует пользовательского взаимодействия и не отображает запрос на вставку.", "Запрос на вставку отображается при чтении буфера обмена. Если буфер обмена содержит данные из того же происхождения, запрос подавляется."]	47 ["С версии 73 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 73 пользователь должен предоставить разрешение `clipboard-write`."]	13.4 Этот метод должен вызываться внутри обработчиков событий пользовательских жестов.	9.0 ["С версии 21.0 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 21.0 пользователь должен предоставить разрешение `clipboard-write`."]	66 ["С версии 107 этот метод должен вызываться внутри обработчиков событий пользовательских жестов или пользователь должен предоставить разрешение `clipboard-write`,", "До версии 107 пользователь должен предоставить разрешение `clipboard-write`."]

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Clipboard/writeText