Разрешения

API управления разрешениями Deno.

Класс, предоставляющий интерфейс для глобального экземпляра Deno.permissions и основанный на веб-платформе Permissions API. Однако некоторые предлагаемые части API, полезные в контексте серверной среды выполнения, были удалены или оставлены без внимания в спецификации веб-платформы, поэтому было решено разместить его в пространстве имён Deno.

По умолчанию, если stdin/stdout является TTY для Deno CLI (то есть может отправлять и получать текст), CLI предложит пользователю предоставить разрешение при запросе разрешения, которое ещё не предоставлено. Это поведение можно изменить с помощью команды --no-prompt при запуске. При запросе CLI будет запрашивать максимально узкое разрешение, что потенциально может раздражать пользователя. API разрешений позволяет автору кода одновременно запрашивать более широкий набор разрешений, чтобы обеспечить более удобный интерфейс для пользователя.

EventTarget, возвращаемый API Deno.permissions, который может сообщать об изменениях состояния разрешения.

Дескриптор разрешения для разрешений allow-env и deny-env, определяющий доступ к чтению и записи переменных среды процесса, а также к другим сведениям о среде. Параметр variable позволяет ограничить разрешение конкретной переменной среды.

Дескриптор разрешения для разрешений allow-ffi и deny-ffi, определяющий доступ к загрузке внешнего кода и взаимодействию с ним через API внешнего интерфейса функций, доступный в Deno. Параметр path позволяет ограничить разрешение конкретным путём на хосте.

Дескриптор разрешения для разрешений allow-import и deny-import, определяющий доступ к импорту с удалённых хостов через сеть. Параметр host позволяет ограничить разрешение на исходящее соединение конкретным хостом и портом.

Дескриптор разрешения для разрешений allow-net и deny-net, определяющий доступ к открытию сетевых портов и подключению к удалённым хостам через сеть. Параметр host позволяет ограничить разрешение на исходящее соединение конкретным хостом и портом.

Набор параметров, позволяющих точно определить разрешения в контексте теста или рабочего процесса.

Интерфейс, определяющий типы событий, поддерживаемые экземплярами PermissionStatus.

Дескриптор разрешения для разрешений allow-read и deny-read, определяющий доступ к чтению ресурсов с локального хоста. Параметр path позволяет ограничить разрешение конкретным путём (а если путь является каталогом — любыми вложенными путями).

Разрешение, предоставленное с помощью allow-read, позволяет коду среды выполнения только пытаться читать данные; операционная система может применять дополнительные разрешения.

Дескриптор разрешения для разрешений allow-run и deny-run, определяющий, какие дочерние процессы могут выполняться в Deno. Параметр command позволяет ограничить разрешение конкретным исполняемым файлом.

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

Дескриптор разрешения для разрешений allow-sys и deny-sys, определяющий доступ к конфиденциальным сведениям о хост-системе, которые вредоносный код может попытаться использовать. Параметр kind позволяет ограничить разрешение конкретным видом сведений.

Дескриптор разрешения для разрешений allow-write и deny-write, определяющий доступ к записи ресурсов на локальном хосте. Параметр path позволяет ограничить разрешение конкретным путём (а если путь является каталогом — любыми вложенными путями).

Разрешение, предоставленное с помощью allow-write, позволяет коду среды выполнения только пытаться записывать данные; операционная система может применять дополнительные разрешения.

Дескрипторы разрешений, определяющие разрешение и позволяющие запрашивать, получать или отзывать его.

Дополнительные сведения о каждом типе разрешения см. в описаниях отдельных дескрипторов.

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

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

"inherit" гарантирует, что в контексте теста будут применены все разрешения родительского процесса. "none" гарантирует, что у контекста теста не будет разрешений. PermissionOptionsObject предоставляет контексту теста более конкретный набор разрешений.

Текущее состояние разрешения:

• "granted" — разрешение предоставлено.
• "denied" — в предоставлении разрешения явно отказано.
• "prompt" — разрешение явно не предоставлено и не запрещено.

API управления разрешениями в Deno.

Это единственный экземпляр объекта Permissions, основанный на API разрешений веб-платформы Permissions API. Однако некоторые предлагаемые части API, полезные в контексте серверной среды выполнения, были удалены или исключены из спецификации веб-платформы, поэтому было решено разместить этот API в пространстве имён Deno.

По умолчанию, если stdin/stdout является TTY для Deno CLI (то есть может отправлять и получать текст), CLI предложит пользователю предоставить разрешение при запросе ещё не предоставленного разрешения. Это поведение можно изменить с помощью команды --no-prompt при запуске. При запросе разрешения CLI запрашивает максимально узкий набор разрешений, что может раздражать пользователя. API разрешений позволяют автору кода за один раз запросить более широкий набор разрешений, чтобы улучшить взаимодействие с пользователем.

Запрос уже предоставленных разрешений не приведёт к появлению запроса пользователю; будет возвращено сообщение о том, что разрешение предоставлено.

Проверка

const status = await Deno.permissions.query({ name: "read", path: "/etc" });
console.log(status.state);

const status = Deno.permissions.querySync({ name: "read", path: "/etc" });
console.log(status.state);

Отзыв

import { assert } from "jsr:@std/assert";

const status = await Deno.permissions.revoke({ name: "run" });
assert(status.state !== "granted")

import { assert } from "jsr:@std/assert";

const status = Deno.permissions.revokeSync({ name: "run" });
assert(status.state !== "granted")

Запрос

const status = await Deno.permissions.request({ name: "env" });
if (status.state === "granted") {
  console.log("'env' permission is granted.");
} else {
  console.log("'env' permission is denied.");
}

const status = Deno.permissions.requestSync({ name: "env" });
if (status.state === "granted") {
  console.log("'env' permission is granted.");
} else {
  console.log("'env' permission is denied.");
}