Кнопка «Копировать» не работает: разрешения и момент записи
Если кнопка «Копировать» не записывает текст, проверьте его готовность, защищённый контекст страницы, условия пользовательской активации и результат writeText. Показывать «Скопировано» можно после подтверждённого завершения записи, а не сразу после нажатия. При отказе оставьте доступный ручной способ получить нужный текст, не запрашивая чтение чужого содержимого буфера.
Кнопка обещает конкретный текст
В учебном интерфейсе человек копирует подготовленный номер обращения. В момент клика он видит одно значение, но приложение ещё ждёт ответ сервера или обновляет состояние. Даже успешная запись не решает задачу, если в буфер попало прежнее значение. Сначала определите, что именно готово к копированию и как это связано с показанной строкой.
Если текст нужно создать запросом, можно отдельно подготовить его и затем дать осознанно скопировать готовый результат. Другой сценарий тоже возможен, но его задержки и условия нужно проверить. Не превращайте невидимое ожидание в обещание мгновенной операции. Для веб-приложения это самостоятельный контракт действия и его результата.
Запись завершает Promise
По MDN writeText метод записывает заданный текст и возвращает Promise, который разрешается после обновления буфера. NotAllowedError сообщает, что запись не разрешена. Поэтому отсутствие синхронного исключения сразу после вызова ещё не является подтверждением успеха.
В интерфейсе различайте подготовку данных, попытку записи, успех и отказ. Если пользователь успел запросить другое значение, поздний ответ первой операции не должен подтверждать вторую. Связывайте обратную связь с конкретным действием и снимком текста, иначе зелёная надпись окажется технически успешной, но вводящей в заблуждение.
Активация и разрешения зависят от среды
В обзоре Clipboard API описаны защищённый контекст и различающиеся браузерные требования к записи. Учитываются разрешения и временная пользовательская активация. Нельзя переносить один способ запроса permissions на все браузеры или считать, что любая асинхронная операция всегда одинаково лишает активации.
Зафиксируйте поддерживаемую среду и путь клика. Если между действием пользователя и записью есть ожидание, проверьте его реальное влияние в нужных браузерах. Старое обсуждение отдельной ошибки не доказывает поведение каждого современного выпуска. Копирование из вложенного интерфейса также проверяется в своём контексте, а не только на отдельной тестовой странице.
Матрица причин и обратной связи
Таблица — собственный диагностический набор, без результатов реального браузерного испытания. Учебная строка не содержит токенов, данных клиента или текущего содержимого системного буфера.
| Наблюдение | Что проверить | Какое основание получено | Поведение интерфейса | Критерий результата |
|---|---|---|---|---|
| После клика копируется старое значение | Снимок текста до записи | Неверное значение могло быть подготовлено раньше API | Показывать и копировать согласованный результат | Пользователь получает именно ожидаемую учебную строку |
| Нет доступного Clipboard API | Контекст и поддержку среды | Причина ещё не установлена по одному undefined | Дать предусмотренный ручной путь | Нет ложного сообщения о выполненной записи |
| Попытка завершилась NotAllowedError | Разрешения, активацию и контекст | Запись отклонена | Сообщить отказ без обвинения пользователя | Ошибка обработана, нужный текст доступен вручную |
| После задержки один браузер отказывает | Путь от клика до writeText | Нужна проверка условий конкретной реализации | Разделить подготовку и действие либо выбрать проверенный путь | Успех подтверждён на заявленных условиях |
| Показывается успех до завершения | Момент смены статуса | Интерфейс опережает результат | Дождаться подтверждения Promise | Надпись относится к завершённой операции |
| Быстро копируются два разных значения | Связь ответов с действиями | Поздний статус может относиться к другой строке | Не подтверждать новую попытку старым результатом | Показано, какое действие фактически завершилось |
Не запрашивайте чтение ради доказательства записи
Операции чтения и записи имеют разные назначения и условия доступа. Для кнопки копирования не нужно скрытно получать прежний буфер или читать его после каждого нажатия. Подтверждение writeText и согласованный учебный прогон дают подходящие основания проверить собственное действие без доступа к постороннему содержимому.
В ручной приёмке участник может сам вставить вымышленную строку в предназначенное для теста поле. Это отличается от фонового программного чтения буфера. Не собирайте вставленные пользователями сведения в журналы без необходимости. Для разработки сайта предусмотрите доступность основного текста и понятные инструкции на поддерживаемых устройствах.
Запасной способ тоже должен работать
Покажите текст в форме, где его можно выделить и получить системной командой копирования. Не прячьте его в недоступном слое и не оставляйте только всплывающую ошибку. Если значение длинное, пользователь должен понимать, что копирует целиком, а не видимый сокращённый фрагмент.
Не объявляйте старый API или искусственно вызванное событие универсальным обходом ограничений. Выбранный альтернативный путь нужно проверить в тех же условиях, что и основную кнопку. Там, где автоматическая запись недоступна, честная инструкция лучше ложного успеха. Это не повод требовать отключить браузерную защиту.
Связанные данные меняются независимо от буфера
Если копируется ссылка на объект, проверьте её состав и доступность отдельно. Успешная запись не доказывает, что адрес ведёт к нужному результату и допустим для получателя. При интеграции через API подготовку значения и его смысл нужно согласовать до передачи в интерфейс.
Буфер также может измениться позже по самостоятельному действию пользователя или другой программы. Не обещайте, что надпись «Скопировано» гарантирует неизменность системного состояния навсегда. Она подтверждает конкретную завершённую попытку. Если для продукта важен момент получения значения, покажите его рядом с текстом понятным способом.
Приёмка по цепочке действия
- Подготовьте различимые вымышленные строки и ожидаемый результат для каждого нажатия. Проверьте, когда значение считается готовым.
- Испытайте запись в согласованных браузерах и контекстах, включая предусмотренный вложенный интерфейс.
- Смоделируйте отказ и задержку подготовки. Интерфейс должен различать ожидание, успех и ошибку.
- Повторите действие с двумя разными значениями и проверьте принадлежность поздних статусов.
- Выполните ручную вставку тестовой строки участником, не читая системный буфер программно ради контроля.
- Проверьте запасной путь и доступность текста при недоступной автоматической записи. Передайте разработчику условия и результат, не содержимое чужого буфера.
Вопросы и ответы
Почему navigator.clipboard.writeText не работает?
Проверьте поддержку API, контекст страницы, условия разрешения и пользовательского действия. Затем дождитесь результата Promise и сопоставьте его с нужным текстом.
Что означает NotAllowedError при clipboard write?
Запись в буфер не была разрешена в текущих условиях. Причину нужно разбирать по конкретному браузеру и контексту, сохранив понятный ручной способ получить текст.
Что проверить, если navigator.clipboard undefined?
Проверьте защищённый контекст и поддержку выбранной среды. Не показывайте «Скопировано» только потому, что кнопка была нажата, если операция записи вообще недоступна.