deno check

deno check выполняет проверку типов кода TypeScript (или JavaScript), не запуская его. Это полезно в конвейерах CI или перед развертыванием, чтобы заранее выявлять ошибки типов. Подробнее о TypeScript в Deno см. в руководстве по TypeScript.

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

›_

deno check main.ts

Проверка нескольких файлов:

›_

deno check src/server.ts src/utils.ts

Выбор области проверки и исключение файлов

Чтобы проверить сразу все файлы в дереве каталогов, можно передать каталоги или шаблоны в качестве позиционных аргументов:

›_

deno check src/
deno check "src/**/*.ts"

Чтобы пропустить файлы или каталоги, используйте поле верхнего уровня exclude в deno.json. Оно применяется к deno check, а также к другим подкомандам, таким как deno fmt и deno lint:

deno.json

{
  "exclude": ["dist/", "vendor/", "**/*.generated.ts"]
}

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

Проверка типов удалённых модулей

По умолчанию проверяются типы только локальных модулей. Используйте --all, чтобы проверять также типы удалённых зависимостей:

›_

deno check --all main.ts

Проверка типов файлов JavaScript

Если у вас проект JavaScript и вы хотите проверять его типы, не добавляя // @ts-check в каждый файл, используйте флаг --check-js:

›_

deno check --check-js main.js

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

deno check завершает работу с ненулевым кодом состояния при наличии ошибок типов, поэтому подходит для конвейеров CI:

›_

deno check main.ts && echo "Types OK"

Обратите внимание: deno test и deno bench по умолчанию уже проверяют типы, поэтому отдельный шаг deno check не нужен, если вы уже запускаете тесты. Используйте deno check, когда нужно проверить типы, ничего не запуская, — например, в качестве быстрого предварительного шага в CI:

›_

deno check main.ts
deno lint
deno test

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

deno check [OPTIONS] [file]...

Загрузить и проверить типы без выполнения.

deno check jsr:@std/http/file-server

Если не указан --reload, эта команда не будет повторно загружать уже кэшированные зависимости

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

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

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

--import-map<FILE>

Загрузить файл import map из локального файла или удалённого 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-пакетов (isolated или 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-пакетов.

Параметры

--all

Проверить типы всего кода, включая удалённые модули и npm-пакеты.

--allow-import, -I<IP_OR_HOSTNAME>необязательный

Разрешить импорт с удалённых хостов. При необходимости укажите разрешённые IP-адреса и имена хостов, а также порты. Значение по умолчанию: deno.land:443,jsr.io:443,esm.sh:443,raw.esm.sh:443,cdn.jsdelivr.net:443,raw.githubusercontent.com:443,gist.githubusercontent.com:443.

--cert<FILE>

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

--check-js

Включить проверку типов файлов JavaScript (эквивалентно compilerOptions.checkJs: true).

--conditions<conditions>

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

--config, -c<FILE>

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

--deny-import<IP_OR_HOSTNAME>необязательный

Запретить импорт с удалённых хостов. При необходимости укажите запрещённые IP-адреса и имена хостов, а также порты.

--doc

Проверять типы в блоках кода JSDoc, а также в основном коде.

--doc-only

Проверять типы только в блоках кода JSDoc и Markdown.

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

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

--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

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

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

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

Параметры Desktop

--desktop

Проверять типы с использованием определений типов для deno desktop.

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

--no-clear-screen

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

--watch

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

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

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