Deno.PermissionOptionsObject

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

interface PermissionOptionsObject {env?: "inherit" | boolean | string[];
ffi?: "inherit" | boolean | Array<string | URL>;
hrtime?: "inherit" | boolean;
net?: "inherit" | boolean | string[];
read?: "inherit" | boolean | Array<string | URL>;
run?: "inherit" | boolean | Array<string | URL>;
sys?: "inherit" | boolean | string[];
write?: "inherit" | boolean | Array<string | URL>;
}

Свойства

env?: "inherit" | boolean | string[]

Указывает, должно ли быть запрошено или отозвано разрешение env. Если установлено значение "inherit", текущее разрешение env будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение env. Если установлено значение false, будет отозвано глобальное разрешение env.

По умолчанию false.

ffi?: "inherit" | boolean | Array<string | URL>

Указывает, должно ли быть запрошено или отозвано разрешение ffi. Если установлено значение "inherit", текущее разрешение ffi будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение ffi. Если установлено значение false, будет отозвано глобальное разрешение ffi.

По умолчанию false.

hrtime?: "inherit" | boolean

Указывает, должно ли быть запрошено или отозвано разрешение hrtime. Если установлено значение "inherit", текущее разрешение hrtime будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение hrtime. Если установлено значение false, будет отозвано глобальное разрешение hrtime.

По умолчанию false.

net?: "inherit" | boolean | string[]

Указывает, должно ли быть запрошено или отозвано разрешение net. Если установлено значение "inherit", текущее разрешение net будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение net. Если установлено значение false, будет отозвано глобальное разрешение net. Если установлено значение string[], разрешение net будет запрошено со строками хоста в формате "<host>[:<port>].

По умолчанию false.

Примеры:

import { assertEquals } from "https://deno.land/std/testing/asserts.ts";

Deno.test({
  name: "inherit",
  permissions: {
    net: "inherit",
  },
  async fn() {
    const status = await Deno.permissions.query({ name: "net" })
    assertEquals(status.state, "granted");
  },
});

import { assertEquals } from "https://deno.land/std/testing/asserts.ts";

Deno.test({
  name: "true",
  permissions: {
    net: true,
  },
  async fn() {
    const status = await Deno.permissions.query({ name: "net" });
    assertEquals(status.state, "granted");
  },
});

import { assertEquals } from "https://deno.land/std/testing/asserts.ts";

Deno.test({
  name: "false",
  permissions: {
    net: false,
  },
  async fn() {
    const status = await Deno.permissions.query({ name: "net" });
    assertEquals(status.state, "denied");
  },
});

import { assertEquals } from "https://deno.land/std/testing/asserts.ts";

Deno.test({
  name: "localhost:8080",
  permissions: {
    net: ["localhost:8080"],
  },
  async fn() {
    const status = await Deno.permissions.query({ name: "net", host: "localhost:8080" });
    assertEquals(status.state, "granted");
  },
});

read?: "inherit" | boolean | Array<string | URL>

Указывает, должно ли быть запрошено или отозвано разрешение read. Если установлено значение "inherit", текущее разрешение read будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение read. Если установлено значение false, будет отозвано глобальное разрешение read. Если установлено значение Array<string | URL>, будет запрошено разрешение read с указанными путями к файлам.

По умолчанию false.

run?: "inherit" | boolean | Array<string | URL>

Указывает, должно ли быть запрошено или отозвано разрешение run. Если установлено значение "inherit", текущее разрешение run будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение run. Если установлено значение false, будет отозвано глобальное разрешение run.

По умолчанию false.

sys?: "inherit" | boolean | string[]

Указывает, должно ли быть запрошено или отозвано разрешение sys. Если установлено значение "inherit", текущее разрешение sys будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение sys. Если установлено значение false, будет отозвано глобальное разрешение sys.

По умолчанию false.

write?: "inherit" | boolean | Array<string | URL>

Указывает, должно ли быть запрошено или отозвано разрешение write. Если установлено значение "inherit", текущее разрешение write будет унаследовано. Если установлено значение true, будет запрошено глобальное разрешение write. Если установлено значение false, будет отозвано глобальное разрешение write. Если установлено значение Array<string | URL>, будет запрошено разрешение write с указанными путями к файлам.

По умолчанию false.