Referencia de Vanilla JS
create18waysEngine(options)
Importar desde @18ways/core/engine.
import { create18waysEngine } from '@18ways/core/engine';Opciones comunes:
| Opción | Tipo | Notas |
|---|---|---|
apiKey | cadena | Requerido. |
baseLocale | cadena | Idioma de origen. |
localización | cadena | Configuración regional actual. |
context | cadena | objeto | Clave de contexto predeterminada. |
initialTranslations | Traducciones | Caché de inicio opcional. |
apiUrl | cadena | Anulación opcional de la base de la API. |
fetcher | typeof fetch | Implementación de búsqueda personalizada. |
cacheTtlSeconds | número | Tiempo de vida de la caché de la solicitud. |
origin | cadena | Origen reenviado en solicitudes del lado del servidor. |
Métodos de motor
t(text, options?)
Traduce una cadena y devuelve el valor resuelto.
setLocale(locale)
Cambia la configuración regional de destino.
getLocale()
Lee la configuración regional actual.
getStore()
Accede a la tienda de traducción subyacente.
TranslationStore
engine.getStore() expone la máquina de estados de ejecución de nivel inferior. El store es el propietario del estado de locale,
la configuración, las traducciones hidratadas, las cadenas de origen recordadas y el estado de carga bloqueante.
Métodos comunes:
| Método | Notas |
|---|---|
getState() | Lee la configuración regional actualmente seleccionada, la configuración regional establecida, la configuración y las traducciones almacenadas en caché. |
hidratar(input) | Fusiona las traducciones y la configuración en el store. Útil para SSR o arranques personalizados. |
deshidratar() | Convierte el almacén en una carga útil de hidratación apta para la fusión. |
cargarConfiguración() | Obtén las configuraciones regionales aceptadas y la configuración de reserva una sola vez, y luego almacena en caché el resultado. |
setLocale(locale) | Inicia una transición de configuración regional dentro de la tienda. |
getTranslationSync(input) | Lectura síncrona que devuelve un valor listo o una lectura pendiente con un valor alternativo. |
getTranslation(input) | Lectura de traducción asíncrona que se resuelve en la cadena traducida final. |
¿isLoading(input?) | Devuelve true cuando aún hay trabajo de traducción bloqueante pendiente, globalmente o para un contexto. |
esperarAIdle(input?) | Se resuelve cuando se estabiliza el trabajo de traducción en curso. Pasa timeoutMs para dejar de esperar tras un tiempo límite mientras la carga continúa en segundo plano. |
getIdleState(input?) | Devuelve el estado de espera cronometrada propiedad de la tienda usado por los renderizadores: {timedOut, promise}. |
montar(entry) / desmontar(entry) | Seguimiento opcional de puntos de montaje para integraciones que habilitan la recolección de basura consciente de los puntos de montaje. |
Si usas @18ways/core directamente, normalmente te quedas en el nivel de engine.t(...). Recurre al almacén cuando estés construyendo tu propio runtime de renderizado o capa de hidratación.
t() opciones
| Opción | Tipo | Notas |
|---|---|---|
localización | cadena | Sobrescribir la configuración regional objetivo para esta llamada. |
baseLocale | cadena | Sobrescribir la configuración regional base para esta llamada. |
context | cadena | objeto | Sobrescribir el contexto para esta llamada. |
vars | Registro<string, desconocido> | Entrada variable para waysParser. |
Utility exports
El paquete principal también exporta ayudantes de nivel inferior como:
fetchAcceptedLocalesfetchConfig- utilidades de localización
Úsalos cuando los necesites, pero el motor debería ser el punto de partida por defecto.