Браузер специально не даёт произвольному сайту полный список локальных принтеров и право незаметно отправлять задания. Поэтому фраза «принтер установлен в Windows, но сайт его не видит» часто описывает не ошибку драйвера, а границу безопасности веб-платформы.

Сначала сформулируйте требование. Для договора A4 обычно достаточно системного окна печати. Для этикетки после каждого сканирования нужен другой путь: локальный агент, kiosk-режим под управлением организации или API конкретного класса устройств.

Четыре способа и их цена

ПодходПлюсыОграничения
window.print()Не требует установки агентаПользователь выбирает устройство и подтверждает печать
PDF/файл для печатиПредсказуемый документ и архивДополнительный шаг оператора
Локальный print-agentОчередь, выбор принтера, silent workflowУстановка, обновления, аутентификация и защита localhost
Device API/SDKПрямое управление поддерживаемым оборудованиемСовместимость браузеров и явные разрешения

Если нужен обычный системный диалог

Подготовьте отдельный print layout: уберите навигацию, задайте размеры, переносы и поля через print CSS. Не считайте факт вызова `window.print()` подтверждением печати — браузер не обязан сообщать сайту, какой принтер выбрали и завершилось ли физическое задание.

@media print {
  nav, .actions { display: none; }
  .document { width: 100%; color: #000; }
}

printButton.addEventListener('click', () => window.print());

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

Локальный агент — отдельный продукт, а не обход браузера

Агент принимает подписанное задание от сайта, проверяет origin, пользователя, срок и список разрешённых принтеров, затем передаёт его в системную очередь. Нельзя поднимать на localhost endpoint, который печатает любой полученный URL без аутентификации: тогда чужая страница сможет расходовать бумагу или отправлять опасные команды устройству.

  • Связывайте агент с конкретной организацией и рабочим местом.
  • Подписывайте каждое задание и защищайте его от повторного выполнения.
  • Разрешайте только ожидаемые форматы и ограничивайте размер.
  • Показывайте оператору очередь, ошибку драйвера и возможность повторить задание.
  • Обновляйте агент через проверенный подписанный канал.

Диагностика уже установленного решения

  1. Распечатать тестовую страницу из Windows — это проверяет устройство и драйвер.
  2. Отправить документ через системный диалог браузера — это проверяет print layout и путь браузер–ОС.
  3. Проверить статус локального агента и его журнал без содержимого документов.
  4. Сопоставить job_id сайта, агента и системной очереди.
  5. Проверить ошибку на отключённом и занятом принтере, а не только успешный случай.

Как выбрать архитектуру без лишней сложности

Если оператор печатает несколько документов в день, системный диалог обычно безопаснее и дешевле. Если это касса или склад с сотнями этикеток, оправдан управляемый агент и заранее назначенное устройство. Для ограниченного парка специализированных USB-принтеров оцените vendor SDK и поддерживаемый браузерный API, но сохраните fallback.

Для оценки задачи нужны модель принтера, формат задания, операционная система, требование к silent print и число рабочих мест. Пароли удалённого доступа и реальные документы для первичного разбора не нужны.

Проверенные источники