std-env

Runtime agnostic JS utils

Installation

# Using npm
npm i std-env

# Using pnpm
pnpm i std-env

# Using yarn
yarn add std-env

Usage

// ESM
import { env, isDevelopment, isProduction } from "std-env";

// CommonJS
const { env, isDevelopment, isProduction } = require("std-env");

Flags

• hasTTY
• hasWindow
• isDebug
• isDevelopment
• isLinux
• isMacOS
• isMinimal
• isProduction
• isTest
• isWindows
• platform
• isColorSupported
• nodeVersion
• nodeMajorVersion

You can read more about how each flag works from ./src/flags.ts.

Provider Detection

std-env can automatically detect the current runtime provider based on environment variables.

You can use isCI and platform exports to detect it:

import { isCI, provider, providerInfo } from "std-env";

console.log({
  isCI, // true
  provider, // "github_actions"
  providerInfo, // { name: "github_actions", isCI: true }
});

List of well known providers can be found from ./src/providers.ts.

Runtime Detection

std-env can automatically detect the current JavaScript runtime based on global variables, following the WinterCG Runtime Keys proposal:

import { runtime, runtimeInfo } from "std-env";

// "" | "node" | "deno" | "bun" | "workerd" | "lagon" ...
console.log(runtime);

// { name: "node" }
console.log(runtimeInfo);

You can also use individual named exports for each runtime detection:

• isNetlify
• isEdgeLight
• isWorkerd
• isDeno
• isLagon
• isNode
• isBun
• isFastly

List of well known providers can be found from ./src/runtimes.ts.

Platform-Agnostic env

std-env provides a lightweight proxy to access environment variables in a platform agnostic way.

import { env } from "std-env";

Platform-Agnostic process

std-env provides a lightweight proxy to access process object in a platform agnostic way.

import { process } from "std-env";

License

MIT

Current Tags

• 3.4.3                                ...           latest (2 years ago)

29 Versions

• 3.4.3                                ...           2 years ago
• 3.4.2                                ...           2 years ago
• 3.4.1                                ...           2 years ago
• 3.4.0                                ...           2 years ago
• 3.3.3                                ...           3 years ago
• 3.3.2                                ...           3 years ago
• 3.3.1                                ...           3 years ago
• 3.3.0                                ...           3 years ago
• 3.2.1                                ...           3 years ago
• 3.1.1                                ...           4 years ago
• 3.1.0 [deprecated]           ...           4 years ago
• 3.0.1                                ...           4 years ago
• 3.0.0                                ...           4 years ago
• 3.0.0-0                                ...           4 years ago
• 2.3.1                                ...           4 years ago
• 2.3.0                                ...           5 years ago
• 3.0.0-alpha [deprecated]           ...           5 years ago
• 2.2.1                                ...           7 years ago
• 2.2.0                                ...           7 years ago
• 2.1.1                                ...           7 years ago
• 2.1.0                                ...           7 years ago
• 2.0.2                                ...           7 years ago
• 2.0.1                                ...           7 years ago
• 2.0.0                                ...           7 years ago
• 1.3.1                                ...           7 years ago
• 1.3.0                                ...           8 years ago
• 1.2.0                                ...           8 years ago
• 1.1.0                                ...           8 years ago
• 1.0.0                                ...           8 years ago