a cross-platform env config lib
npm install zhi-enva cross-platform env config lib
For simple use
``js
import { Env } from "zhi-env"
const env = new Env({
"some-key": "some-value",
})
const val = env.getEnv("some-key")
console.log("val=>", val)
`
For vite
`js
import { Env } from "zhi-env"
const env = new Env(import.meta.env)
const val = env.getEnv("some-key")
console.log("val=>", val)
`
For Nuxt framework
`ts
// https://github.com/vitejs/vite/issues/9539#issuecomment-1206301266
import { Env } from "zhi-env"
const nuxtEnv = useRuntimeConfig()
const env = new Env(nuxtEnv)
// 访问公共变量
// const env = new Env(nuxtEnv.public)
const val = env.getEnv("some-key")
console.log("val=>", val)
`
For Astro framework or other libs
`ts
import { Env } from "zhi-env"
// 1 add "module": "esnext" to tsconfig.json
// add "target": "esnext" to tsconfig.json
// 2 add env.d.ts
// ``
// interface ImportMeta {
// readonly env: ImportMetaEnv
// }
// `
// 3 (optional) if you are using esbuild, add define to esbuild.
// `
// const defineEnv = {
// NODE_ENV: isProduction ? "production" : "development",
// ...getNormalizedEnvDefines(["NODE", "VITE_"]),
// }
// bundledEsbuildConfig.define = {}
// bundledEsbuildConfig.define = {
// ...bundledEsbuildConfig.define,
// "import.meta.env": JSON.stringify(defineEnv),
// }
//
const envMeta = import.meta.env
const env = new Env(import.meta.env)
const val = env.getEnv("some-key")
console.log("val=>", val)
`
For unit tests
- vitestrecommend
`ts`
// simple
describe("zhiEnv", () => {
it("test env", () => {
const env = new Env(import.meta.env)
expect(env.getEnv(EnvConstants.NODE_ENV_KEY)).toEqual("test")
})
})
- jest
`ts
import { getNormalizedEnvDefines } from "../../../packages/esbuild-config-custom/esmUtils"
describe("zhiEnv", () => {
const NOT_EXIST_KEY = "NOT_EXIST_KEY"
getNormalizedEnvDefines(["NODE", "VITE_"])
it("test env", () => {
const env = new Env(import.meta.env)
expect(env.getEnv(EnvConstants.NODE_ENV_KEY)).toEqual("test")
})
it("test debug mode", () => {
const env = new Env(import.meta.env)
expect(env.getEnv(EnvConstants.VITE_DEBUG_MODE_KEY)).toEqual("true")
})
})
`
``Congregations! zhi-env need no deps, it is just pure js code 🎉
`bash`
pnpm dev -F zhi-env
`bash`
pnpm build -F zhi-env
`bash`
pnpm doc -F zhi-env
pnpm md -F zhi-env
Execute the unit tests via vitest
`bash`
pnpm test -F zhi-env
`bash``
pnpm publish -F zhi-env --tag latest