lexmount:env

lexmount:env 提供实例配置的环境变量，适合读取 API 地址、业务选项和凭据。无需访问宿主进程；宿主操作系统的环境变量不会自动暴露给代码。

import env from 'lexmount:env';

const endpoint = env.API_URL;
if (!endpoint) throw new Error('请先配置 API_URL');
console.log(await (await fetch(endpoint)).text());

默认导出 env

功能： 提供本次执行的冻结只读对象。模块仅有默认导出，没有 get()、set() 或其他配置方法。

declare const env: Readonly<Record<string, string | undefined>>;

读取变量

使用 env.KEY 或 env[key] 读取变量。

返回值： 已配置时为 string，未配置时为 undefined。空字符串、空白和换行原样保留；不会自动转为数字、布尔值或 JSON。应根据业务需要显式解析。

import env from 'lexmount:env';

const retries = Number(env.RETRIES ?? '3');
const enabled = env.ENABLED === 'true';
const apiKey = env['API_KEY'];
if (apiKey === undefined) throw new Error('缺少 API_KEY');

配置与快照

在实例详情的「环境变量」Tab 编辑 key/value 并保存。Key 必须以字母或下划线开头，且仅含字母、数字和下划线。保存配置不会修改正在执行的代码所读取的值。

每次提交运行时固定一份快照，排队和重试沿用该快照；再次提交运行才会读取新配置。删除全部行并保存可清空配置。代码与变量合计受运行请求大小限制，配置可以在控制台回显编辑。

在 HTTP handler 中读取

默认导出的 HTTP handler 也可以导入此模块。Handler 的第二个参数是独立的冻结空对象，应从模块导入 env 读取实例变量。

import env from 'lexmount:env';

export default {
  fetch() {
    return Response.json({ mode: env.MODE ?? 'default' });
  },
};

env 已冻结，赋值或删除属性不能更新配置，在 ES module 严格模式中会抛出 TypeError。存储后端和浏览器身份由平台配置，不能通过设置同名业务变量覆盖。

类型声明见 env.d.ts。