Deno

Глобальное пространство имён, где расположены специфичные для Deno нестандартные API.

Пространство имён

Набор конструкторов ошибок, которые генерируются API Deno.

Классы

Deno.Buffer устаревший	Буфер байтов переменного размера с методами `read()` и `write()`.
Deno.errors.AddrInUse	Вызывается при попытке открыть слушатель сервера на адресе и порту, на которых уже работает другой слушатель.
Deno.errors.AddrNotAvailable	Вызывается, когда операционная система сообщает об ошибке `EADDRNOTAVAIL`.
Deno.errors.AlreadyExists	Вызывается при попытке создать ресурс, например, файл, который уже существует.
Deno.errors.BadResource	Базовый ресурс ввода-вывода недействителен или закрыт, поэтому операция не может быть выполнена.
Deno.errors.BrokenPipe	Вызывается при попытке записи в ресурс, и происходит ошибка «разрыв канала». Это может произойти при попытке записи напрямую в `stdout` или `stderr`, и операционная система не может передать вывод по каналу по причине, внешней для среды выполнения Deno.
Deno.errors.Busy	Вызывается, когда базовый ресурс ввода-вывода недоступен, потому что он ожидает обработки в другом блоке кода.
Deno.errors.ConnectionAborted	Вызывается, когда операционная система сообщает об ошибке `ECONNABORTED`.
Deno.errors.ConnectionRefused	Вызывается, когда операционная система сообщает о том, что подключение к ресурсу отклонено.
Deno.errors.ConnectionReset	Вызывается, когда операционная система сообщает о том, что подключение было прервано. В случае с сетевыми серверами это может быть нормальным явлением, когда клиент прерывает соединение вместо его корректного завершения.
Deno.errors.Http	Вызывается в ситуациях, когда при попытке загрузить динамический импорт было обнаружено слишком много редиректов.
Deno.errors.Interrupted	Вызывается, когда операционная система сообщает об ошибке `EINTR`. Во многих случаях эта внутренняя ошибка ввода-вывода будет обработана внутри Deno или приведёт к ошибке @{link BadResource}.
Deno.errors.InvalidData	Вызывается, когда операция возвращает невалидные данные для выполняемой операции.
Deno.errors.NotConnected	Вызывается, когда операционная система сообщает об ошибке `ENOTCONN`.
Deno.errors.NotFound	Вызывается, когда операционная система указывает, что файл не найден.
Deno.errors.NotSupported	Вызывается, когда от API Deno требуется выполнить функцию, которая в настоящее время не поддерживается.
Deno.errors.PermissionDenied	Вызывается, когда операционная система указывает, что текущий пользователь, под которым работает процесс Deno, не имеет соответствующих прав доступа к файлу или ресурсу, или пользователь не предоставил необходимый флаг `--allow-*`.
Deno.errors.TimedOut	Вызывается, когда операционная система сообщает о том, что операция ввода-вывода истекла (`ETIMEDOUT`).
Deno.errors.UnexpectedEof	Вызывается при попытке чтения байтов из ресурса, но неожиданно встречен конец файла.
Deno.errors.WriteZero	Вызывается, когда ожидаемая запись в буфер ввода-вывода привела к записи нуля байтов.
Deno.FsFile	Абстракция Deno для чтения и записи файлов.
Deno.Permissions
Deno.PermissionStatus
Deno.Process	Представляет экземпляр дочернего процесса, возвращаемого из `Deno.run`, который можно использовать для управления дочерним процессом.

Перечисления

Deno.SeekMode

Перечисление, определяющее режим поиска для API ввода-вывода, поддерживающих поиск.

Переменные

Deno.args	Возвращает аргументы скрипта для программы. Например, если мы запускаем программу:
Deno.build	Информация, связанная со сборкой.
Deno.customInspect устаревший	Символ, который может быть использован в качестве ключа для пользовательского метода, который будет вызван при вызове `Deno.inspect()`, или при выводе объекта в консоль.
Deno.env	Интерфейс, содержащий методы для взаимодействия с переменными окружения процесса.
Deno.File устаревший	Абстракция Deno для чтения и записи файлов.
Deno.mainModule	URL точки входа модуля, заданного в командной строке.
Deno.noColor	Отражает переменную среды `NO_COLOR` при запуске программы.
Deno.permissions	API управления разрешениями Deno.
Deno.pid	Текущий идентификатор процесса этого экземпляра Deno CLI.
Deno.ppid	Идентификатор процесса родительского процесса этого экземпляра Deno CLI.
Deno.stderr	Ссылка на `stderr`, которая может быть использована для прямой записи в `stderr`. Реализует специфичные для Deno интерфейсы {@link `Writer`, {@link `WriterSync`}, и {@link `Closer`}, а также предоставляет интерфейс `WritableStream`.
Deno.stdin	Ссылка на `stdin`, которая может быть использована для прямого чтения из `stdin`. Реализует специфичные для Deno интерфейсы {@link `Reader`, {@link `ReaderSync`}, и {@link `Closer`}, а также предоставляет интерфейс `ReadableStream`.
Deno.stdout	Ссылка на `stdout`, которая может быть использована для прямой записи в `stdout`. Реализует специфичные для Deno интерфейсы {@link `Writer`, {@link `WriterSync`}, и {@link `Closer`}, а также предоставляет интерфейс `WritableStream`.
Deno.version	Информация, связанная с версией.

Функции

Deno.addSignalListener	Регистрирует заданную функцию в качестве обработчика заданного события сигнала.
Deno.chdir	Изменяет текущую рабочую директорию на указанный путь.
Deno.chmod	Изменяет права доступа к указанному файлу/директории. Игнорирует umask процесса.
Deno.chmodSync	Синхронно изменяет права доступа к указанному файлу/директории. Игнорирует umask процесса.
Deno.chown	Изменяет владельца обычного файла или директории.
Deno.chownSync	Синхронно изменяет владельца обычного файла или директории.
Deno.close	Закрывает указанный идентификатор ресурса (`rid`), ранее открытый, например, при открытии или создании файла. Закрытие файла по завершении работы с ним важно для предотвращения утечки ресурсов.
Deno.connect	Подключается к хосту (по умолчанию "127.0.0.1") и порту на указанном транспорте (по умолчанию "tcp") и возвращает соединение (`Conn`).
Deno.connectTls	Устанавливает защищенное соединение через TLS (transport layer security) с использованием необязательного файла сертификата, хоста (по умолчанию "127.0.0.1") и порта. Файл сертификата необязателен, если он не указан, используются корневые сертификаты Mozilla (см. также https://github.com/ctz/webpki-roots для подробностей)
Deno.copy deprecated	Копирует данные из `src` в `dst` до достижения конца файла (`null`) в `src` или возникновения ошибки. Возвращает количество скопированных байтов или отклоняет с первой ошибкой, возникшей во время копирования.
Deno.copyFile	Копирует содержимое и права одного файла в другой указанный путь, по умолчанию создавая новый файл, если он не существует, иначе перезаписывая. Возвращает ошибку, если целевой путь является каталогом или недоступен для записи.
Deno.copyFileSync	Синхронно копирует содержимое и права одного файла в другой указанный путь, по умолчанию создавая новый файл, если он не существует, иначе перезаписывая. Возвращает ошибку, если целевой путь является каталогом или недоступен для записи.
Deno.create	Создает файл, если он не существует, или обнуляет существующий файл и возвращает экземпляр `Deno.FsFile`.
Deno.createSync	Синхронно создает файл, если он не существует, или обнуляет существующий файл и возвращает экземпляр `Deno.FsFile`.
Deno.cwd	Возвращает строку, представляющую текущую рабочую директорию.
Deno.execPath	Возвращает путь к текущей исполняемой программе Deno.
Deno.exit	Выход из процесса Deno с необязательным кодом завершения.
Deno.fdatasync	Очищает любые ожидающие операции с данными для данного потока файла в диск. `const file = await Deno.open( "my_file.txt", { read: true, write: true, create: true }, ); await Deno.write(file.rid, new TextEncoder().encode("Hello World")); await Deno.fdatasync(file.rid); console.log(new TextDecoder().decode(await Deno.readFile("my_file.txt"))); // Hello World`
Deno.fdatasyncSync	Синхронно очищает любые ожидающие операции с данными для данного потока файла в диск.
Deno.fstat	Возвращает `Deno.FileInfo` для данного потока файла.
Deno.fstatSync	Синхронно возвращает `Deno.FileInfo` для данного потока файла.
Deno.fsync	Очищает любые ожидающие операции с данными и метаданными для данного потока файла в диск.
Deno.fsyncSync	Синхронно очищает любые ожидающие операции с данными и метаданными для данного потока файла в диск.
Deno.ftruncate	Усекает или расширяет указанный поток файла до указанного `len`.
Deno.ftruncateSync	Синхронно усекает или расширяет указанный поток файла до указанного `len`.
Deno.hostname	Получить `hostname` машины, на которой запущен процесс Deno.
Deno.inspect	Преобразует входные данные в строку, имеющую тот же формат, что и вывод `console.log()`.
Deno.isatty	Проверяет, является ли данный идентификатор ресурса (`rid`) TTY (терминалом).
Deno.iter deprecated	Преобразует Reader, `r`, в асинхронный итератор.
Deno.iterSync deprecated	Преобразует ReaderSync, `r`, в итератор.
Deno.kill	Отправить сигнал процессу по указанному `pid`.
Deno.link	Создает `newpath` как жёсткую ссылку на `oldpath`.
Deno.linkSync	Синхронно создает `newpath` как жёсткую ссылку на `oldpath`.
Deno.listen	Прослушивает локальный адрес транспорта.
Deno.listenTls	Прослушивает локальный адрес транспорта по TLS (transport layer security).
Deno.lstat	Возвращает `Deno.FileInfo` для указанного `path`. Если `path` является символической ссылкой, информация о символической ссылке будет возвращена вместо того, на что она указывает.
Deno.lstatSync	Синхронно возвращает `Deno.FileInfo` для указанного `path`. Если `path` является символической ссылкой, информация о символической ссылке будет возвращена вместо того, на что она указывает.
Deno.makeTempDir	Создаёт новую временную директорию в стандартной директории для временных файлов, если `dir` не указано. Дополнительные опции включают префикс и суффикс имени директории `prefix` и `suffix` соответственно.
Deno.makeTempDirSync	Синхронно создаёт новую временную директорию в стандартной директории для временных файлов, если `dir` не указано. Дополнительные опции включают префикс и суффикс имени директории `prefix` и `suffix` соответственно.
Deno.makeTempFile	Создаёт новый временный файл в стандартной директории для временных файлов, если `dir` не указано.
Deno.makeTempFileSync	Синхронно создаёт новый временный файл в стандартной директории для временных файлов, если `dir` не указано.
Deno.memoryUsage	Возвращает объект, описывающий использование памяти процессом Deno и подсистемой V8 в байтах.
Deno.metrics	Получение метрик со стороны привилегированной части Deno. Используется в основном для разработки Deno. Ops, также называемые bindings, служат посредниками между JavaScript-песочницей Deno и остальной частью Deno.
Deno.mkdir	Создаёт новую директорию по указанному пути.
Deno.mkdirSync	Синхронно создаёт новую директорию по указанному пути.
Deno.open	Открывает файл и возвращает экземпляр `Deno.FsFile`. Файл не обязательно должен существовать предварительно, если используются опции открытия `create` или `createNew`. Ответственность за закрытие файла после использования лежит на вызывающей стороне.
Deno.openSync	Синхронно открывает файл и возвращает экземпляр `Deno.FsFile`. Файл не обязательно должен существовать предварительно, если используются опции открытия `create` или `createNew`. Ответственность за закрытие файла после использования лежит на вызывающей стороне.
Deno.read	Чтение из ресурса (`rid`) в буфер массива (`buffer`).
Deno.readAll deprecated	Чтение Reader `r` до конца файла (`null`) и возвращение содержимого как Uint8Array.
Deno.readAllSync deprecated	Синхронно читает Reader `r` до конца файла (`null`) и возвращает содержимое как `Uint8Array`.

Deno.readDir	Читает директорию, заданную значением `path`, и возвращает асинхронную итерируемую последовательность `Deno.DirEntry`.
Deno.readDirSync	Синхронно читает директорию, заданную значением `path`, и возвращает итерируемую последовательность `Deno.DirEntry`.
Deno.readFile	Читает и возвращает всё содержимое файла как массив байтов. `TextDecoder` может быть использован для преобразования байтов в строку, если это необходимо. Чтение директории возвращает пустой массив данных.
Deno.readFileSync	Синхронно читает и возвращает всё содержимое файла как массив байтов. `TextDecoder` может быть использован для преобразования байтов в строку, если это необходимо. Чтение директории возвращает пустой массив данных.
Deno.readLink	Возвращает полный путь назначения указанной символической ссылки.
Deno.readLinkSync	Синхронно возвращает полный путь назначения указанной символической ссылки.
Deno.readSync	Синхронно читает из ресурса с идентификатором (`rid`) в буфер массива (`buffer`).
Deno.readTextFile	Асинхронно читает и возвращает всё содержимое файла как строку UTF-8. Чтение директории вызовет ошибку.
Deno.readTextFileSync	Синхронно читает и возвращает всё содержимое файла как строку UTF-8. Чтение директории вызовет ошибку.
Deno.realPath	Возвращает абсолютный нормализованный путь, с разрешенными символическими ссылками.
Deno.realPathSync	Синхронно возвращает абсолютный нормализованный путь, с разрешенными символическими ссылками.
Deno.refTimer	Заставляет таймер заданного `id` блокировать завершение цикла событий.
Deno.remove	Удаляет указанный файл или директорию.
Deno.removeSignalListener	Удаляет зарегистрированного слушателя сигнала, который был зарегистрирован с помощью `Deno.addSignalListener`.
Deno.removeSync	Синхронно удаляет указанный файл или директорию.
Deno.rename	Переименовывает (перемещает) `oldpath` в `newpath`. Пути могут быть файлами или директориями. Если `newpath` уже существует и не является директорией, `rename()` заменяет его. Применимы системные ограничения, если `oldpath` и `newpath` находятся в разных директориях.
Deno.renameSync	Синхронно переименовывает (перемещает) `oldpath` в `newpath`. Пути могут быть файлами или директориями. Если `newpath` уже существует и не является директорией, `renameSync()` заменяет его. Применимы системные ограничения, если `oldpath` и `newpath` находятся в разных директориях.
Deno.resolveDns
Deno.resources	Возвращает карту открытых идентификаторов ресурсов (rid) вместе с их строковыми представлениями. Это внутренний API, и представление ресурса имеет тип `unknown`, что означает, что он может измениться в любое время и на нём не следует полагаться.
Deno.run	Запускает новый дочерний процесс. RunOptions должны содержать как минимум `opt.cmd`, массив аргументов программы, первый из которых — бинарный файл.
Deno.seek	Перемещает указатель ресурса с идентификатором (`rid`) к заданной `offset` в соответствии со способом, заданным `whence`. Вызов возвращает новую позицию в ресурсе (байты от начала).
Deno.seekSync	Синхронно перемещает указатель ресурса с идентификатором (`rid`) к заданной `offset` в соответствии со способом, заданным `whence`. Возвращает новую позицию в ресурсе (байты от начала).
Deno.serveHttp	Обрабатывает HTTP-запросы, используя сокет TCP или TLS.
Deno.shutdown	Завершает операции отправки сокета.
Deno.startTls	Начинает TLS-рукопожатие от существующего соединения с использованием необязательного списка сертификатов CA и имени хоста (по умолчанию «127.0.0.1»). Указание сертификатов CA необязательно. По умолчанию используются настроенные корневые сертификаты. Для использования этой функции требуется, чтобы другая сторона соединения была готова к TLS-рукопожатию.
Deno.stat	Возвращает `Deno.FileInfo` для указанного `path`. Всегда следует за символическими ссылками.
Deno.statSync	Синхронно возвращает `Deno.FileInfo` для указанного `path`. Всегда следует за символическими ссылками.
Deno.symlink	Создаёт `newpath` как символическую ссылку на `oldpath`.
Deno.symlinkSync	Синхронно создаёт `newpath` как символическую ссылку на `oldpath`.
Deno.test	Регистрирует тест, который будет запущен при использовании `deno test` в командной строке и содержащий модуль выглядит как модуль теста.
Deno.truncate	Усекает (или расширяет) указанный файл до указанной `len`. Если `len` не указано, всё содержимое файла усекается.
Deno.truncateSync	Синхронно усекает (или расширяет) указанный файл до указанной `len`. Если `len` не указано, всё содержимое файла усекается.
Deno.unrefTimer	Заставляет таймер заданного `id` не блокировать завершение цикла событий.
Deno.upgradeWebSocket	Используется для обновления входящего HTTP-запроса до WebSocket.
Deno.watchFs	Отслеживает события файловой системы для одного или нескольких `paths`, которые могут быть файлами или директориями. Эти пути должны существовать. Одно пользовательское действие (например, `touch test.file`) может породить несколько событий файловой системы. Аналогично, одно пользовательское действие может привести к нескольким путям файлов в одном событии (например, `mv old_name.txt new_name.txt`).
Deno.write	Записывает в ресурс с идентификатором (`rid`) содержимое буфера массива (`data`).
Deno.writeAll deprecated	Записывает всё содержимое буфера массива (`arr`) в писатель (`w`).
Deno.writeAllSync deprecated	Синхронно записывает всё содержимое буфера массива (`arr`) в писатель (`w`).
Deno.writeFile	Записывает `data` в указанный `path`, по умолчанию создавая новый файл при необходимости, иначе перезаписывая.
Deno.writeFileSync	Синхронно записывает `data` в указанный `path`, по умолчанию создавая новый файл при необходимости, иначе перезаписывая.
Deno.writeSync	Синхронно записывает в ресурс с идентификатором (`rid`) содержимое буфера массива (`data`).
Deno.writeTextFile	Записывает строку `data` в указанный `path`, по умолчанию создавая новый файл при необходимости, иначе перезаписывая.
Deno.writeTextFileSync	Синхронно записывает строку `data` в указанный `path`, по умолчанию создавая новый файл при необходимости, иначе перезаписывая.

Интерфейсы

Deno.CAARecord	Если `resolveDns` вызывается с типом записи "CAA", она вернёт массив этого интерфейса.
Deno.Closer	Абстрактный интерфейс, при реализации которого предоставляется возможность закрывать файлы/ресурсы, которые были ранее открыты.
Deno.Conn
Deno.ConnectOptions
Deno.ConnectTlsOptions
Deno.DirEntry	Информация о записи каталога, возвращаемая из `Deno.readDir` и `Deno.readDirSync`.
Deno.Env	Интерфейс, содержащий методы для взаимодействия с переменными окружения процесса.
Deno.EnvPermissionDescriptor
Deno.FfiPermissionDescriptor
Deno.FileInfo	Предоставляет информацию о файле и возвращается функциями `Deno.stat`, `Deno.lstat`, `Deno.statSync` и `Deno.lstatSync`, а также при вызове `stat()` и `statSync()` на экземпляре `Deno.FsFile`.
Deno.FsEvent	Представляет уникальное событие файловой системы, возвращаемое объектом `Deno.FsWatcher`.
Deno.FsWatcher	Возвращается функцией `Deno.watchFs`. Это асинхронный итератор, возвращающий системные события. Для остановки наблюдения за файловой системой используйте метод `.close()`.
Deno.HrtimePermissionDescriptor
Deno.HttpConn
Deno.InspectOptions	Опции, которые можно указать при выполнении `Deno.inspect`.
Deno.Listener	Универсальный сетевой слушатель для потоковых протоколов.
Deno.ListenOptions
Deno.ListenTlsOptions
Deno.MakeTempOptions	Опции, которые можно задать при использовании `Deno.makeTempDir`, `Deno.makeTempDirSync`, `Deno.makeTempFile` и `Deno.makeTempFileSync`.
Deno.MemoryUsage
Deno.Metrics
Deno.MkdirOptions	Опции, которые можно задать при использовании `Deno.mkdir` и `Deno.mkdirSync`.
Deno.MXRecord	Если `resolveDns` вызывается с типом записи "MX", она вернёт массив этого интерфейса.
Deno.NAPTRRecord	Если `resolveDns` вызывается с типом записи "NAPTR", она вернёт массив этого интерфейса.
Deno.NetAddr
Deno.NetPermissionDescriptor
Deno.OpenOptions	Опции, которые можно задать при выполнении `Deno.open` и `Deno.openSync`.
Deno.OpMetrics
Deno.PermissionOptionsObject	Набор опций, которые могут определить разрешения в контексте теста или работника на очень специфическом уровне.
Deno.PermissionStatusEventMap
Deno.Reader	Абстрактный интерфейс, при реализации которого предоставляется возможность асинхронного чтения байтов в буфер массива.
Deno.ReaderSync	Абстрактный интерфейс, при реализации которого предоставляется возможность синхронного чтения байтов в буфер массива.
Deno.ReadFileOptions	Опции, которые можно задать при использовании `Deno.readFile` или `Deno.readFileSync`.
Deno.ReadPermissionDescriptor
Deno.RemoveOptions	Опции, которые можно задать при использовании `Deno.remove` и `Deno.removeSync`.
Deno.RequestEvent
Deno.ResolveDnsOptions
Deno.ResourceMap	Карта открытых ресурсов, отслеживаемых Deno. Ключ — идентификатор ресурса (rid), значение — его представление.
Deno.RunOptions	Опции, которые можно использовать с `Deno.run`.
Deno.RunPermissionDescriptor
Deno.Seeker	Абстрактный интерфейс, при реализации которого предоставляется возможность асинхронного поиска внутри открытого файла/ресурса.
Deno.SeekerSync	Абстрактный интерфейс, при реализации которого предоставляется возможность синхронного поиска внутри открытого файла/ресурса.
Deno.SetRawOptions	НЕУСТОЙЧИВО: новый API, ещё не проверен.
Deno.SOARecord	Если `resolveDns` вызывается с типом записи "SOA", она вернёт массив этого интерфейса.
Deno.SRVRecord	Если `resolveDns` вызывается с типом записи "SRV", она вернёт массив этого интерфейса.
Deno.StartTlsOptions
Deno.SysPermissionDescriptor
Deno.TcpConn
Deno.TestContext	Контекст, передаваемый в функцию тестирования, который можно использовать для получения информации о текущем тесте или регистрации дополнительных шагов теста.
Deno.TestDefinition
Deno.TestStepDefinition
Deno.TlsConn
Deno.TlsHandshakeInfo
Deno.TlsListener	Специализированный слушатель, принимающий TLS-соединения.
Deno.UnixAddr
Deno.UnixConn
Deno.UpgradeWebSocketOptions
Deno.WebSocketUpgrade
Deno.WriteFileOptions	Опции для записи в файл.
Deno.WritePermissionDescriptor
Deno.Writer	Абстрактный интерфейс, при реализации которого предоставляется возможность асинхронной записи байтов из буфера массива в файл/ресурс.
Deno.WriterSync	Абстрактный интерфейс, при реализации которого предоставляется возможность синхронной записи байтов из буфера массива в файл/ресурс.

Типы псевдонимов

Deno.Addr
Deno.FsEventFlag	Дополнительная информация для объектов FsEvent с типом "other".
Deno.PermissionDescriptor	Описатели разрешений, которые определяют разрешение и могут быть запрошены, запрошены или отозваны.
Deno.PermissionName	Имя привилегированной функции, для которой требуется разрешение.
Deno.PermissionOptions	Параметры, определяющие разрешения в контексте теста или worker.
Deno.PermissionState	Текущий статус разрешения:
Deno.ProcessStatus	Статус, полученный из метода `.status()` экземпляра `Deno.Process`.
Deno.RecordType	Тип записи ресурса. В настоящее время поддерживаются только указанные типы.
Deno.Signal	Сигналы операционной системы, на которые можно подписаться или которые можно отправить дочерним процессам. Какие сигналы и каково их стандартное поведение зависят от операционной системы.
Deno.SymlinkOptions