Saltearse al contenido

Referencia de la API de variables de entorno

Agregado en: astro@5.0.0

La API astro:env te permite configurar un esquema seguro para las variables de entorno que hayas establecido. Esto te permite indicar si deben estar disponibles en el servidor o en el cliente, y definir su tipo de datos y propiedades adicionales. Para ver ejemplos e instrucciones de uso, consulta la guía de astro:env.

import {
getSecret,
} from 'astro:env/server';

Agregado en: astro@5.0.0

La función auxiliar getSecret() permite recuperar el valor bruto de una variable de entorno mediante su clave.

Por ejemplo, puedes recuperar un valor booleano como una cadena de texto:

import {
FEATURE_FLAG, // boolean
getSecret
} from 'astro:env/server'
getSecret('FEATURE_FLAG') // string | undefined

Esto también puede ser útil para obtener un secreto no definido en tu esquema, por ejemplo, uno que dependa de datos dinámicos de una base de datos o API.

Si necesitas recuperar variables de entorno mediante programación, te recomendamos utilizar getSecret() en lugar de process.env (o equivalente). Dado que su implementación la proporciona tu adaptador, no tendrás que actualizar todas tus llamadas si cambias de adaptador. El valor predeterminado es process.env en dev y build.

Contribuir Comunidad Patrocinador