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
.
Importaciones desde astro:env
Sección titulada «Importaciones desde astro:env»import { getSecret, } from 'astro:env/server';
getSecret()
Sección titulada «getSecret()»
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.