deno watch

Команда deno watch запускает программу и перезагружает её при изменении исходных файлов. Это краткая форма команды deno run --watch-hmr: программа запускается с включённой горячей заменой модулей, поэтому при изменении Deno заменяет обновлённые модули на месте, когда это возможно, вместо полного перезапуска.

Использование

›_

deno watch main.ts

Это эквивалентно:

›_

deno run --watch-hmr main.ts

Поскольку deno watch повторно использует deno run, работают все флаги deno run, включая параметры отслеживания файлов:

--watch-hmr=<paths> добавляет дополнительные пути для отслеживания.
--watch-exclude=<paths> исключает пути, изменения в которых не должны вызывать перезагрузку.
--no-clear-screen сохраняет предыдущий вывод, не очищая экран при каждой перезагрузке.

›_

deno watch --watch-exclude=dist/ -RN main.ts

Использование в командной строке:

deno watch [OPTIONS] [SCRIPT_ARG]...

Запускает программу на JavaScript или TypeScript, отслеживает изменения файлов и выполняет горячую замену модулей.

Это псевдоним для deno run --watch-hmr. Если горячая замена не удаётся, процесс перезапускается.

deno watch main.ts

По умолчанию отслеживаются локальные файлы из графа модулей точки входа. Дополнительные пути можно передать с помощью --watch-hmr:

deno watch --watch-hmr=./templates main.ts

Параметры проверки типов

--check<CHECK_TYPE>необязательно

Включить проверку типов. Эта подкоманда по умолчанию не проверяет типы; укажите --check=all, чтобы также проверять удалённые модули. В качестве альтернативы используйте подкоманду «deno check».

--no-check<NO_CHECK_TYPE>необязательно

Пропустить проверку типов. Если указано значение «remote», диагностические ошибки удалённых модулей будут игнорироваться.

Параметры управления зависимостями

--cached-only

Требовать, чтобы удалённые зависимости уже находились в кэше.

--frozen<BOOLEAN>необязательно

Завершить работу с ошибкой, если файл блокировки не актуален.

--import-map<FILE>

Загрузить файл карты импортов из локального файла или по удалённому URL.

--lock<FILE>необязательно

Проверить указанный файл блокировки. (Если значение не задано, используется "./deno.lock" по умолчанию.)

--no-lock

Отключить автоматический поиск файла блокировки.

--no-npm

Не разрешать npm-модули.

--no-remote

Не разрешать удалённые модули.

--node-modules-dir<MODE>необязательно

Выбирает режим каталога node_modules для npm-пакетов (не путь). Возможные значения: auto (создать локальный каталог node_modules и установить в него npm-пакеты), manual (использовать существующий локальный каталог node_modules, не изменяя его), none (не использовать локальный каталог node_modules; разрешать npm-пакеты из глобального кэша). Если флаг указан без значения, по умолчанию используется auto.

--node-modules-linker<MODE>

Задаёт режим связывания npm-пакетов (изолированный или hoisted).

--reload, -r<CACHE_BLOCKLIST>необязательно

Перезагрузить кэш исходного кода (повторно скомпилировать TypeScript). Если значение не указано, перезагружается всё. Передайте список спецификаторов через запятую, чтобы перезагрузить только указанные модули; npm: перезагружает все npm-модули; npm:chalk перезагружает один npm-модуль; jsr:@std/http/file-server,jsr:@std/assert/assert-equals перезагружает указанные модули.

--vendor<vendor>необязательно

Включает или отключает использование локальной папки vendor для удалённых модулей и папки node_modules для npm-пакетов.

Параметры

--allow-scripts<PACKAGE>необязательно

Разрешить выполнение скриптов жизненного цикла npm для указанных пакетов. Примечание: скрипты выполняются только при использовании каталога node_modules (--node-modules-dir).

--cert<FILE>

Загрузить центр сертификации из файла в кодировке PEM.

--conditions<conditions>

Используйте этот аргумент, чтобы указать пользовательские условия для экспортов npm-пакетов. Также можно использовать переменную среды DENO_CONDITIONS. .

--config, -c<FILE>

Настроить различные параметры Deno, включая TypeScript, linting и форматирование кода. Обычно файл конфигурации называется deno.json или deno.jsonc и определяется автоматически; в этом случае указывать этот флаг не нужно.

--coverage<DIR>необязательно

Собирать данные профиля покрытия в DIR. Если DIR не указан, используется 'coverage/'. Этот параметр также можно задать с помощью переменной среды DENO_COVERAGE_DIR.

--cpu-prof

Запустить профилировщик ЦП V8 при запуске и записать профиль на диск при завершении. По умолчанию профили записываются в текущий каталог.

--cpu-prof-dir<DIR>

Каталог для записи профилей ЦП V8. Неявно включает --cpu-prof.

--cpu-prof-flamegraph

Создать SVG-флеймграф вместе с профилем ЦП.

--cpu-prof-interval<MICROSECONDS>

Интервал выборки для профилирования ЦП в микросекундах (по умолчанию: 1000).

--cpu-prof-md

Создать удобный для чтения отчёт в формате Markdown вместе с профилем ЦП.

--cpu-prof-name<NAME>

Имя файла профиля ЦП (по умолчанию CPU...cpuprofile).

--env-file<FILE>необязательно

Загрузить переменные среды из локального файла. Для каждого ключа используется только первая переменная среды. Существующие переменные среды процесса не перезаписываются, поэтому значения переменных с уже существующими в среде именами сохраняются. Если в файле .env несколько объявлений одной переменной среды, применяется первое найденное. Порядок определяется последовательностью файлов, переданных в аргументах.

--ext<ext>

Задать тип содержимого указанного файла.

--location<HREF>

Значение globalThis.location, используемое некоторыми веб-API.

--minimum-dependency-age<minimum-dependency-age>

(Нестабильный параметр) Возраст в минутах, длительность ISO-8601 или абсолютная временная метка RFC3339 (например, '120' — два часа, 'P2D' — два дня, '2025-09-16' — дата отсечения, '2025-09-16T12:00:00+00:00' — время отсечения, '0' — отключить).

--no-code-cache

Отключить кэш кода V8.

--no-config

Отключить автоматическую загрузку файла конфигурации.

--preload<FILE>

Список файлов, которые будут выполнены до основного модуля.

--require<FILE>

Список модулей CommonJS, которые будут выполнены до основного модуля.

--seed<NUMBER>

Задать начальное значение генератора случайных чисел.

--tunnel, -t<tunnel>необязательно

Выполнять задачи через туннель к Deno Deploy.

Создать защищённое соединение между локальным компьютером и Deno Deploy, предоставляя доступ к централизованным переменным среды, ведению журналов и публикации данных из локальной среды в общедоступном интернете.

--use-env-proxy

Использовать HTTP_PROXY, HTTPS_PROXY и NO_PROXY для node:http/node:https.

--v8-flags<V8_FLAGS>необязательно

Чтобы увидеть список всех доступных флагов, используйте --v8-flags=--help. Флаги также можно задать с помощью переменной среды DENO_V8_FLAGS. Флаги, заданные этим параметром, добавляются после значений переменной среды DENO_V8_FLAGS.

Параметры отладки

--inspect<HOST_PORT>необязательно

Включить инспектор на host:port [по умолчанию: 127.0.0.1:9229]. Узел и порт указывать необязательно. Если указать порт 0, будет назначен случайный свободный порт.

--inspect-brk<HOST_PORT>необязательно

Включить инспектор на host:port, дождаться подключения отладчика и остановиться в начале пользовательского скрипта.

--inspect-wait<HOST_PORT>необязательно

Включить инспектор на host:port и дождаться подключения отладчика перед выполнением пользовательского кода.

Параметры отслеживания файлов

--no-clear-screen

Не очищать экран терминала в режиме отслеживания.

--watch<FILES>необязательно

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

--watch-exclude<FILES>необязательно

Исключить указанные файлы и шаблоны из режима отслеживания.

--watch-hmr<FILES>необязательно

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