Без категории
пространство имён Deno
Глобальное пространство имён, в котором находятся специфичные для Deno нестандартные API.
Классы
Абстракция Deno для чтения файлов и записи в них.
Пользовательский HttpClient для использования с функцией fetch. Он предназначен для использования пользовательских сертификатов или прокси-серверов с fetch().
Тип-обёртка для 64-разрядных беззнаковых целых чисел, используемых в качестве значений в Deno.Kv.
API управления разрешениями Deno.
Объект EventTarget, возвращаемый API Deno.permissions, который предоставляет информацию об изменениях состояния разрешения.
Небезопасный указатель на функцию для передачи функций JavaScript в качестве указателей на функции C при вызове внешних функций.
Небезопасный указатель на функцию, предназначенный для вызова функций, отсутствующих в виде символов.
Небезопасное представление области памяти, на которую указывает значение pointer. API UnsafePointerView соответствует стандартному встроенному интерфейсу DataView для доступа к базовым типам в области памяти (числам, строкам и необработанным байтам).
Создаёт пригодную для вывода поверхность WebGPU из переданных дескрипторов окна и дисплея.
Перечисления
Перечисление, определяющее режим позиционирования для API ввода-вывода, поддерживающих позиционирование.
Функции
Регистрирует указанную функцию в качестве обработчика указанного сигнала.
Регистрирует тест производительности, который будет запущен при использовании deno bench в командной строке, если содержащий его модуль распознан как модуль для тестов производительности.
Изменяет текущий рабочий каталог на указанный путь.
Изменяет разрешения для файла или каталога по указанному пути. Игнорирует маску разрешений процесса.
Синхронно изменяет разрешения для файла или каталога по указанному пути. Игнорирует маску разрешений процесса.
Изменяет владельца обычного файла или каталога.
Синхронно изменяет владельца обычного файла или каталога.
Подключается к узлу (по умолчанию "127.0.0.1") и порту, используя указанный транспорт (по умолчанию "tcp"), и возвращает соединение (Conn).
Устанавливает защищённое соединение по QUIC, используя имя узла и порт. Файл сертификата необязателен; если он не указан, будут использоваться корневые сертификаты Mozilla. Подробности см. также на странице https://github.com/ctz/webpki-roots.
Устанавливает защищённое соединение через TLS (защиту транспортного уровня), используя необязательный список сертификатов CA, имя узла (по умолчанию "127.0.0.1") и порт.
Возвращает размер консоли в столбцах и строках.
Копирует содержимое и разрешения одного файла по указанному пути в другой файл, по умолчанию создавая новый файл при необходимости или перезаписывая существующий. Выдаёт ошибку, если целевой путь указывает на каталог или файл недоступен для записи.
Синхронно копирует содержимое и разрешения одного файла по указанному пути в другой файл, по умолчанию создавая новый файл при необходимости или перезаписывая существующий. Выдаёт ошибку, если целевой путь указывает на каталог или файл недоступен для записи.
Создаёт файл, если он не существует, или очищает существующий файл и возвращает экземпляр Deno.FsFile.
Создаёт пользовательский HttpClient для использования с fetch. Это расширение Fetch API веб-платформы, которое позволяет Deno использовать пользовательские сертификаты TLS CA и подключаться через прокси при использовании fetch().
Создаёт файл, если он не существует, или очищает существующий файл и возвращает экземпляр Deno.FsFile.
Создаёт задание cron, которое будет периодически выполнять предоставленный обработчик согласно указанному расписанию.
Возвращает строку с текущим рабочим каталогом.
Открывает внешнюю динамическую библиотеку и регистрирует символы, позволяя вызывать внешние функции.
Возвращает путь к текущему исполняемому файлу deno.
Завершает процесс Deno с необязательным кодом завершения.
Возвращает идентификатор группы процесса на POSIX-платформах. В Windows возвращает null.
Возвращает hostname компьютера, на котором работает процесс Deno.
Преобразует входные данные в строку в том же формате, что и вывод console.log().
Создаёт newpath как жёсткую ссылку на oldpath.
Синхронно создаёт newpath как жёсткую ссылку на oldpath.
Открывает прослушивание на локальном транспортном адресе.
Открывает прослушивание на локальном транспортном адресе.
Открывает прослушивание на локальном транспортном адресе через TLS (защиту транспортного уровня).
Возвращает массив со средними значениями нагрузки за 1, 5 и 15 минут. Средняя нагрузка — это показатель использования ЦП и операций ввода-вывода за последние одну, пять и 15 минут, выраженный дробным числом. Ноль означает отсутствие нагрузки. В Windows все три значения всегда одинаковы и отражают текущую нагрузку, а не среднюю нагрузку за 1, 5 и 15 минут.
Возвращает Deno.FileInfo для указанного path. Если path является символической ссылкой, будут возвращены сведения о самой ссылке, а не о том, на что она указывает.
Синхронно возвращает Deno.FileInfo для указанного path. Если path является символической ссылкой, будут возвращены сведения о самой ссылке, а не о том, на что она указывает.
Создаёт новый временный каталог в каталоге для временных файлов по умолчанию, если не указан dir. Среди других необязательных параметров — добавление prefix в начало и suffix в конец имени каталога.
Синхронно создаёт новый временный каталог в каталоге для временных файлов по умолчанию, если не указан dir. Среди других необязательных параметров — добавление prefix в начало и suffix в конец имени каталога.
Создаёт новый временный файл в каталоге для временных файлов по умолчанию, если не указан dir.
Синхронно создаёт новый временный файл в каталоге для временных файлов по умолчанию, если не указан dir.
Возвращает объект с данными об использовании памяти процессом Deno и подсистемой V8, измеренными в байтах.
Создаёт новый каталог по указанному пути.
Синхронно создаёт новый каталог по указанному пути.
Возвращает массив со сведениями о сетевых интерфейсах.
Открывает файл и возвращает экземпляр Deno.FsFile. Файл может не существовать заранее, если используются параметры открытия create или createNew. Вызывающий код может объявить переменную файла с ключевым словом using, чтобы среда выполнения автоматически закрыла файл, когда он выйдет из области видимости.
Открывает новое соединение Deno.Kv для сохранения данных.
Синхронно открывает файл и возвращает экземпляр Deno.FsFile. Файл может не существовать заранее, если используются параметры открытия create или createNew. Вызывающий код может объявить переменную файла с ключевым словом using, чтобы среда выполнения автоматически закрыла файл, когда он выйдет из области видимости.
Возвращает версию операционной системы.
Возвращает время работы операционной системы в секундах.
Читает каталог, указанный в path, и возвращает асинхронный итерируемый объект Deno.DirEntry. Порядок записей не гарантируется.
Синхронно читает каталог, указанный в path, и возвращает итерируемый объект Deno.DirEntry. Порядок записей не гарантируется.
Читает всё содержимое файла и возвращает его в виде массива байтов. При необходимости для преобразования байтов в строку можно использовать TextDecoder. При чтении каталога возвращает ошибку.
Синхронно читает всё содержимое файла и возвращает его в виде массива байтов. При необходимости для преобразования байтов в строку можно использовать TextDecoder. При чтении каталога выбрасывает ошибку.
Возвращает полный путь к целевому объекту указанной символической ссылки.
Синхронно возвращает полный путь к целевому объекту указанной символической ссылки.
Асинхронно читает всё содержимое файла и возвращает его в виде строки, декодированной из UTF-8.
Синхронно читает всё содержимое файла и возвращает его в виде строки, декодированной из UTF-8.
Возвращает абсолютный нормализованный путь с разрешёнными символическими ссылками.
Синхронно возвращает абсолютный нормализованный путь с разрешёнными символическими ссылками.
Не позволяет циклу событий завершиться, пока активен таймер, указанный в id.
Удаляет указанный файл или каталог.
Удаляет указанный обработчик сигнала, зарегистрированный с помощью Deno.addSignalListener.
Синхронно удаляет указанный файл или каталог.
Переименовывает (перемещает) oldpath в newpath. Пути могут указывать на файлы или каталоги. Если newpath уже существует и не является каталогом, rename() заменяет его. Если oldpath и newpath находятся в разных каталогах, могут действовать ограничения, зависящие от операционной системы.
Синхронно переименовывает (перемещает) oldpath в newpath. Пути могут указывать на файлы или каталоги. Если newpath уже существует и не является каталогом, renameSync() заменяет его. Если oldpath и newpath находятся в разных каталогах, могут применяться ограничения, зависящие от ОС.
Выполняет DNS-запрос и возвращает разрешённые записи.
Обрабатывает HTTP-запросы с помощью указанного обработчика.
Запускает новый дочерний процесс и возвращает его дескриптор Deno.ChildProcess.
Запускает дочерний процесс, ожидает его завершения и возвращает результат.
Синхронно запускает дочерний процесс, ожидает его завершения и возвращает результат.
Запускает TLS-рукопожатие для существующего соединения, используя необязательный список сертификатов ЦС и имя хоста (по умолчанию — "127.0.0.1"). Указывать сертификаты ЦС необязательно. По умолчанию используются настроенные корневые сертификаты. Для использования этой функции другая сторона соединения должна быть готова к TLS-рукопожатию.
Возвращает объект Deno.FileInfo для указанного path. Всегда следует по символическим ссылкам.
Синхронно возвращает объект Deno.FileInfo для указанного path. Всегда следует по символическим ссылкам.
Создаёт newpath как символическую ссылку на oldpath.
Создаёт newpath как символическую ссылку на oldpath.
Отображает общий объём свободной и используемой физической памяти и памяти подкачки в системе, а также буферы и кэш, используемые ядром.
Обрезает (или расширяет) указанный файл до заданного размера len. Если len не указан, содержимое файла обрезается полностью.
Синхронно обрезает (или расширяет) указанный файл до заданного размера len. Если len не указан, содержимое файла обрезается полностью.
Возвращает идентификатор пользователя процесса на POSIX-платформах. В Windows возвращает null.
Получает маску создания файлов процесса. Если указано mask, устанавливает маску создания файлов процесса. Этот вызов всегда возвращает значение маски, установленное до вызова.
Настраивает таймер заданного id так, чтобы он не препятствовал завершению цикла событий.
Преобразует входящий HTTP-запрос в WebSocket-соединение.
Преобразует QUIC-соединение в экземпляр WebTransport.
Изменяет время доступа (atime) и время изменения (mtime) объекта файловой системы, на который ссылается path. Указанное время задаётся в секундах (время эпохи UNIX) или в виде объектов Date.
Синхронно изменяет время доступа (atime) и время изменения (mtime) объекта файловой системы, на который ссылается path. Указанное время задаётся в секундах (время эпохи UNIX) или в виде объектов Date.
Отслеживает события файловой системы для одного или нескольких paths, которые могут указывать на файлы или каталоги. Эти пути должны уже существовать. Одно действие пользователя (например, touch test.file) может вызвать несколько событий файловой системы. Аналогично, одно действие пользователя может привести к появлению нескольких путей к файлам в одном событии (например, mv old_name.txt new_name.txt).
Записывает data в указанный path, по умолчанию создавая новый файл, если он не существует, или перезаписывая существующий.
Синхронно записывает data в указанный path, по умолчанию создавая новый файл, если он не существует, или перезаписывая существующий.
Записывает строку data в указанный path, по умолчанию создавая новый файл, если он не существует, или перезаписывая существующий.
Синхронно записывает строку data в указанный path, по умолчанию создавая новый файл, если он не существует, или перезаписывая существующий.
Интерфейсы
Проверка, выполняемая в рамках Deno.AtomicOperation. Проверка завершится неудачей, если метка версии пары «ключ-значение» в хранилище KV не совпадает с указанной меткой версии. Проверка с меткой версии null позволяет убедиться, что пара «ключ-значение» в данный момент не существует в хранилище KV.
Учетные данные для базовой аутентификации, используемые с сервером Deno.Proxy при указании Deno.CreateHttpClientOptions.
Контекст, передаваемый тестируемой функции. Экземпляр используется совместно всеми итерациями теста производительности. Его методы можно использовать, например, чтобы изменить измеряемую часть функции.
Интерфейс для определения теста производительности с помощью Deno.bench.
Если вызвать Deno.resolveDns, указав тип записи "CAA", результатом будет массив объектов, соответствующих этому интерфейсу.
Параметры, которые можно указать при вызове Deno.Command.
Интерфейс, возвращаемый при вызове Deno.Command.output или Deno.Command.outputSync; он представляет результат запуска дочернего процесса.
Параметры, которые можно указать при подключении с помощью Deno.connect.
Параметры, которые можно указать при установлении TLS-соединения с помощью Deno.connectTls.
Параметры, используемые при создании Deno.HttpClient.
CronSchedule — интерфейс для представления расписания cron в формате JSON schedule.
Универсальный прослушиватель транспортного уровня для протоколов, ориентированных на сообщения.
Сведения об элементе каталога, возвращаемые функциями Deno.readDir и Deno.readDirSync.
Ресурс динамической библиотеки. Используйте Deno.dlopen, чтобы загрузить динамическую библиотеку и получить этот интерфейс.
Дескриптор разрешений для разрешений allow-env и deny-env, которые регулируют доступ к чтению и записи переменных окружения процесса, а также к другим сведениям об окружении. Параметр variable позволяет ограничить разрешение конкретной переменной окружения.
Дескриптор разрешений для разрешений allow-ffi и deny-ffi, которые регулируют доступ к загрузке внешнего кода и взаимодействию с ним через API интерфейса иностранных функций, доступный в Deno. Параметр path позволяет ограничить разрешение определённым путём на хосте.
Предоставляет сведения о файле и возвращается функциями Deno.stat, Deno.lstat, Deno.statSync и Deno.lstatSync, а также при вызове stat() и statSync() для экземпляра Deno.FsFile.
Интерфейс внешней функции, определяемый типами её параметров и результата.
Дескриптор интерфейса внешней библиотеки.
Представляет отдельное событие файловой системы, выдаваемое объектом Deno.FsWatcher.
Возвращается функцией Deno.watchFs. Это асинхронный итератор, выдающий системные события. Чтобы прекратить наблюдение за файловой системой, вызовите метод .close().
Дескриптор разрешений для разрешений allow-import и deny-import, которые регулируют доступ к импорту с удалённых узлов по сети. Параметр host позволяет ограничить разрешение на исходящее соединение определёнными узлом и портом.
Параметр, который можно указать при вызове Deno.inspect.
Параметры для перечисления пар «ключ-значение» в Deno.Kv.
Параметры, которые можно задать при открытии слушателя с помощью Deno.listen.
Параметры, которые можно задать при открытии TLS-слушателя с помощью Deno.listenTls.
Параметры, которые можно задать при использовании Deno.makeTempDir, Deno.makeTempDirSync, Deno.makeTempFile и Deno.makeTempFileSync.
Параметры, которые можно задать при использовании Deno.mkdir и Deno.mkdirSync.
Представляет членство в группе многоадресной рассылки IPv4.
Представляет членство в группе многоадресной рассылки IPv6.
Если Deno.resolveDns вызывается с указанным типом записи "MX", функция возвращает массив объектов, реализующих этот интерфейс.
Если Deno.resolveDns вызывается с указанным типом записи "NAPTR", функция возвращает массив объектов, реализующих этот интерфейс.
Адрес сетевого соединения или слушателя, использующего транспорт на основе IP.
Дескриптор разрешения для разрешений allow-net и deny-net, которые управляют доступом к открытию сетевых портов и подключению к удалённым узлам через сеть. Параметр host позволяет ограничить разрешение исходящих подключений конкретным узлом и портом.
Сведения о сетевом интерфейсе, возвращаемые вызовом Deno.networkInterfaces.
Параметры, которые можно задать при вызове Deno.open и Deno.openSync.
Интерфейс, определяющий типы событий, поддерживаемые экземплярами PermissionStatus.
Ненулевой указатель, представленный во время выполнения в виде объекта. Прототип объекта — null, и его нельзя изменить. Объект нельзя присвоить ни одной из сторон, поэтому он полностью доступен только для чтения.
Входящее соединение, для которого сервер ещё не начал свою часть рукопожатия.
Специализированный слушатель, принимающий QUIC-соединения.
Параметры, которые можно задать при использовании Deno.readFile или Deno.readFileSync.
Дескриптор разрешения для разрешений allow-read и deny-read, которые управляют доступом к чтению ресурсов с локального узла. Параметр path позволяет ограничить разрешение конкретным путём (а если путь указывает на каталог — и любыми вложенными путями).
Параметры, которые можно задать при использовании Deno.remove и Deno.removeSync.
Параметры, которые можно задать при использовании Deno.resolveDns.
Дескриптор разрешения для разрешений allow-run и deny-run, которые управляют доступом к запускаемым Deno дочерним процессам. Параметр command позволяет ограничить разрешение конкретным исполняемым файлом.
Интерфейс, которому должен соответствовать модуль, запускаемый с помощью подкоманды deno serve.
Параметры, которые можно задать при вызове Deno.serve.
Параметры, которые можно передать в Deno.serve для создания сервера, прослушивающего TCP-порт.
Параметры, которые можно передать в Deno.serve для создания сервера, прослушивающего доменный сокет Unix.
Параметры, которые можно передать в Deno.serve для создания сервера, прослушивающего сокет VSOCK.
Если Deno.resolveDns вызывается с указанным типом записи "SOA", он возвращает массив объектов, реализующих этот интерфейс.
Если Deno.resolveDns вызывается с указанным типом записи "SRV", он возвращает массив объектов, реализующих этот интерфейс.
Параметры, которые можно задать при переводе существующего соединения на TLS с помощью Deno.startTls.
Интерфейс потоков stdout и stderr дочернего процесса, возвращаемых Deno.Command.spawn.
Дескриптор разрешения для разрешений allow-sys и deny-sys, контролирующих доступ к конфиденциальной информации хост-системы, которую вредоносный код может попытаться использовать в своих целях. Параметр kind позволяет ограничить разрешение доступом к определённым сведениям.
Информация, возвращаемая вызовом Deno.systemMemoryInfo.
Контекст, передаваемый тестовой функции. Его можно использовать для получения сведений о текущем тесте или регистрации дополнительных шагов внутри него.
Регистрирует параметризованную группу тестов. См. DenoTest.each.
Краткая форма свойства для пропуска определённого тестового случая. См. DenoTest.ignore.
Краткая форма свойства для выбора определённого тестового случая. См. DenoTest.only.
Параметры, которые можно задать при вызове Deno.TestContext.assertSnapshot.
Предоставляет сертифицированный ключевой материал из строк. Ключевой материал представлен в формате PEM (Privacy Enhanced Mail, https://www.rfc-editor.org/rfc/rfc1422), который можно распознать по маркерам -----BEGIN----- и -----END----- в начале и конце строк. Этот тип ключа несовместим с ключами в формате DER, которые являются двоичными.
Нестабильные параметры, которые можно задать при открытии прослушивателя датаграмм с помощью Deno.listenDatagram.
Адрес сетевого соединения или прослушивателя, использующего доменный сокет Unix.
Потоковое соединение через доменный сокет Unix.
Параметры, которые можно задать при подключении к доменному сокету Unix с помощью Deno.connect.
Нестабильные параметры, которые можно задать при открытии прослушивателя датаграмм unixpacket с помощью Deno.listenDatagram.
Параметры, которые можно задать при открытии прослушивателя Unix с помощью Deno.listen или Deno.listenDatagram.
Параметры, которые можно задать при выполнении обновления Request с помощью Deno.upgradeWebSocket
Адрес сетевого соединения или прослушивателя, использующего транспорт VSOCK для связи виртуальной машины с её хостом.
Потоковое соединение VSOCK.
Параметры, которые можно задать при подключении через VSOCK с помощью Deno.connect.
Параметры, которые можно задать при открытии прослушивателя VSOCK с помощью Deno.listen.
Дескриптор разрешения для разрешений allow-write и deny-write, контролирующих доступ к записи в ресурсы на локальном хосте. Параметр path позволяет ограничить разрешение определённым путём (а если путь указывает на каталог — также и его подкаталогами).
Пространства имён
Объединяет код TypeScript/JavaScript в один файл.
Набор конструкторов ошибок, которые выбрасывают API Deno.
Пространство имён содержит API среды выполнения, доступные в блокнотах Jupyter.
API для работы с фреймворком наблюдаемости OpenTelemetry. Deno может экспортировать трассировки, метрики и журналы в совместимые с OpenTelemetry серверные системы через протокол OTLP.
Пространство имён webgpu предоставляет дополнительные API, не описанные спецификацией WebGPU.
Псевдонимы типов
Адрес сетевого подключения или прослушивающего сокета независимо от транспорта.
CronScheduleExpression используется в качестве типа для minute, hour, dayOfMonth, month и dayOfWeek в CronSchedule.
Преобразование типов возвращаемых значений внешних символов.
Преобразование типов возвращаемых значений внешних символов и параметров небезопасных обратных вызовов.
Дополнительная информация об объектах FsEvent с типом "other".
Уровень согласованности операции KV.
Необязательная версионированная пара ключа и значения в Deno.Kv.
Ключ, сохраняемый в Deno.Kv. Ключ представляет собой последовательность элементов Deno.KvKeyPart.
Отдельная часть Deno.KvKey. Части сортируются лексикографически: сначала по типу, а в пределах одного типа — по значению.
Селектор, который выбирает диапазон данных, возвращаемых операцией списка для Deno.Kv.
Изменение ключа в Deno.Kv. Изменение состоит из ключа, значения и типа. Тип определяет, как изменение применяется к ключу.
Все типы чисел BigInt для взаимодействия с внешними функциями.
Собственный логический тип для взаимодействия с внешними функциями.
Собственный тип буфера для взаимодействия с внешними функциями.
Собственный тип функции для взаимодействия с внешними функциями.
Все типы обычных чисел для взаимодействия с внешними функциями.
Собственный тип указателя для взаимодействия с внешними функциями.
Все поддерживаемые типы для взаимодействия с внешними функциями.
Собственный тип void для взаимодействия с внешними функциями.
Дескрипторы разрешений, определяющие разрешение, которое можно проверить, запросить или отозвать.
Название привилегированной возможности, для которой требуется разрешение.
Параметры, определяющие разрешения в контексте теста или рабочего потока.
Текущее состояние разрешения:
Указатели представлены объектом PointerObject или значением null, если указатель равен null.
Описание альтернативных транспортов (или прокси) в Deno.CreateHttpClientOptions.
Тип ресурсной записи, которую нужно разрешить с помощью DNS и Deno.resolveDns.
Обработчик HTTP-запросов. Принимает запрос и возвращает ответ.
Сигналы операционной системы, которые можно перехватывать или отправлять дочерним процессам. Набор сигналов и их стандартное поведение зависят от ОС.
Вспомогательный тип, выводящий интерфейс внешней библиотеки.
Вспомогательный тип, выводящий внешний символ.
Специализированный прослушивающий сокет, принимающий TCP-подключения.
Специализированный прослушивающий сокет, принимающий TLS-подключения.
Вспомогательный тип для преобразования типов параметров внешних функций.
Преобразование типов возвращаемых значений небезопасных обратных вызовов.
Преобразование типов параметров внешних символов и возвращаемых значений небезопасных обратных вызовов.
Специализированный прослушивающий сокет, принимающий Unix-подключения.
Небезопасная функция обратного вызова.
Специализированный прослушивающий сокет, принимающий подключения VSOCK.
Переменные
Возвращает аргументы скрипта, переданные программе.
Интерфейс, содержащий методы для взаимодействия с переменными окружения процесса.
Код завершения процесса Deno.
URL модуля точки входа, указанного в командной строке. Для доступа требуется разрешение на чтение текущего рабочего каталога (CWD).
Отражает значение переменной окружения NO_COLOR на момент запуска программы.
API управления разрешениями Deno.
ID текущего процесса данного экземпляра CLI Deno.
ID родительского процесса данного экземпляра CLI Deno.
Ссылка на stderr, которую можно использовать для прямой записи в stderr. Она реализует специфичные для Deno интерфейсы Writer, WriterSync и Closer, а также предоставляет интерфейс WritableStream.
Ссылка на stdin, которую можно использовать для прямого чтения из stdin.
Ссылка на stdout, которую можно использовать для прямой записи в stdout. Она реализует специфичные для Deno интерфейсы Writer, WriterSync и Closer, а также предоставляет интерфейс WritableStream.
Регистрирует тест, который будет запущен при использовании deno test в командной строке, если содержащий его модуль распознаётся как тестовый.
© 2018–2025 the Deno authors
Licensed under the MIT License.
https://docs.deno.com/api/deno/uncategorized