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

Базовая версия 2024

Новое

Начиная с июня 2024 года, эта функция работает на последних устройствах и версиях браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.

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

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

Примечание: Чтобы прочитать нетекстовое содержимое из буфера обмена, используйте метод read() вместо этого. Вы можете записать текст в буфер обмена, используя writeText().

Синтаксис

readText()

Параметры

Нет.

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

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

Возвращает пустую строку, если буфер обмена пустой, не содержит текста или не содержит текстовое представление среди объектов, представляющих содержимое буфера обмена.

Исключения

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

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

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

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

Примеры

В этом примере извлекается текстовое содержимое буфера обмена и возвращаемый текст вставляется в содержимое выбранного элемента.

const destination = document.getElementById("outbox");
destinationImage.addEventListener("click", () => {
  navigator.clipboard
    .readText()
    .then((clipText) => (destination.innerText = clipText));
});

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

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

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

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

См. также

© 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/readText