Переменные окружения

Использовать переменные окружения в Deno можно несколькими способами:

Встроенный метод Deno.env

Среда выполнения Deno имеет встроенную поддержку переменных окружения с помощью Deno.env.

У Deno.env есть методы получения и установки значений. Пример использования:

Deno.env.set("FIREBASE_API_KEY", "examplekey123");
Deno.env.set("FIREBASE_AUTH_DOMAIN", "firebasedomain.com");

console.log(Deno.env.get("FIREBASE_API_KEY")); // examplekey123
console.log(Deno.env.get("FIREBASE_AUTH_DOMAIN")); // firebasedomain.com
console.log(Deno.env.has("FIREBASE_AUTH_DOMAIN")); // true

Файл .env

Deno также поддерживает файлы .env. Можно указать Deno считывать переменные окружения из .env с помощью флага --env-file, например:

deno run --env-file main.ts

Будет считан файл .env из текущего рабочего каталога или первого родительского каталога, в котором он есть. Если нужно загрузить переменные окружения из другого файла, укажите этот файл в качестве параметра флага.

Чтобы загрузить переменные из нескольких файлов, можно передать несколько флагов --env-file (например, deno run --env-file=.env.one --env-file=.env.two --allow-env <script>).

@std/dotenv

Пакет dotenv из стандартной библиотеки можно использовать для загрузки переменных окружения из .env.

Предположим, у вас есть файл .env следующего вида:

GREETING="Hello, world."

Импортируйте модуль load, чтобы автоматически импортировать переменные из файла .env в окружение процесса.

import { load } from "jsr:@std/dotenv";

const env = await load({
  // optional: choose a specific path (defaults to ".env")
  envPath: ".env.local",
  // optional: also export to the process environment (so Deno.env can read it)
  export: true,
});

console.log(env.GREETING);
console.log(Deno.env.get("GREETING"));

Запустите это с помощью deno run --allow-read --allow-env app.ts.

Дополнительную документацию по работе с .env можно найти в документации @std/dotenv.

Установка переменной при запуске команды

Как и в других командах CLI, перед запуском команды можно установить переменные окружения, например:

MY_VAR="my value" deno run main.ts

Это полезно, если нужно менять поведение задачи в зависимости от переменной окружения. Такой подход удобно сочетать с командами deno task, например:

{

  ...
  
  "tasks": {
    "build:full": {
      "description": "Build the site with all features",
      "command": "BUILD_TYPE=FULL deno run main.ts"
    },
    "build:light": {
      "description": "Build the site without expensive operations",
      "command": "BUILD_TYPE=LIGHT deno run main.ts"
    }
  }
}

MY_VAR="my value with spaces"

Специальные переменные окружения

Среда выполнения Deno использует следующие специальные переменные окружения.