Inicio/Artículo
Esadax JournalCI

Primeros pasos con Vite en Esadax

Primeros pasos con Vite en Esadax Esadax admite la implementación de proyectos Vite directamente desde su editor de código. Esta guía cubre los conceptos básicos del uso de Vite con Esadax. Uso

Primeros pasos con Vite en Esadax

Esadax admite la implementación de proyectos Vite directamente desde su editor de código. Esta guía cubre los conceptos básicos del uso de Vite con Esadax.

Uso de complementos de la comunidad de Vite

Los plugins de la comunidad de Vite pueden simplificar el proceso de desarrollo y proporcionar funciones adicionales para su proyecto. Algunos plugins populares incluyen:

  • vite-plugin-esadax: Proporciona una forma sencilla de implementar su aplicación Vite en Esadax.
  • vite-plugin-ssr: Habilita la representación del lado del servidor (SSR) para tu aplicación Vite.

Variables de entorno

Esadax proporciona variables de entorno que puede utilizar en su proyecto Vite. Estas variables están disponibles en el momento de la compilación y se puede acceder a ellas mediante el objeto process.env.

Funciones de borde

Edge Functions le permite ejecutar código más cerca de sus usuarios, lo que reduce la latencia y mejora el rendimiento. Para crear una función de borde, cree un nuevo archivo en el directorio api de su proyecto con una extensión .ts o .js.

// api/handler.ts
export const config = {
  runtime: 'edge',
};

export default (request: Request) => {
  return new Response(`Hello, from ${request.url} I'm now an Edge Function!`);
};

Funciones sin servidor

Las funciones sin servidor escalan hacia arriba y hacia abajo según las demandas de tráfico. Para crear una función sin servidor, cree un nuevo archivo en el directorio api de su proyecto con una extensión .ts o .js.

// api/handler.ts
import type { EsadaxRequest, EsadaxResponse } from '@esadax/node';

export default function handler(request: EsadaxRequest, response: EsadaxResponse) {
  response.status(200).json({
    body: request.body,
    query: request.query,
    cookies: request.cookies,
  });
}

Renderización del lado del servidor (SSR)

La representación del lado del servidor le permite representar páginas de forma dinámica en el servidor. Para habilitar SSR, use un complemento de la comunidad de Vite como vite-plugin-ssr.

Usando Vite para hacer SPAs

Si tu aplicación Vite está configurada para implementarse como una aplicación de página única (SPA), los enlaces profundos no funcionarán de forma predeterminada. Para habilitar el enlace profundo en las aplicaciones de SPA Vite, crea un archivo esadax.json en la raíz de tu proyecto y agrega el siguiente código:

{
  "rewrites": [
    {
      "source": "/(.*)",
      "destination": "/index.html"
    }
  ]
}

Ver más beneficios

Esadax proporciona varios beneficios para los proyectos de Vite, incluyendo:

  • Ahorro de costes al utilizar menos recursos que Serverless Functions
  • Capacidad de ejecución en la región más cercana a sus usuarios u orígenes de datos
  • Acceso a la geolocalización y la dirección IP de los visitantes para la personalización basada en la ubicación

Ver más recursos

Para obtener más información sobre la implementación de proyectos de Vite en Esadax, consulte los siguientes recursos:

  • Implementar nuestra plantilla Turborepo
  • Explorar un proyecto de Vite implementado en un monorepo
  • Implemente nuestra plantilla de Sistema de Diseño
  • Explore el repositorio de plantillas de Vite

Para configurar una función de borde usando Vite en Esadax, siga estos pasos organizados:

  1. Crear Estructura del Proyecto:
    • Inicializa tu proyecto con un directorio raíz.
    • Cree un directorio api en la raíz para sus rutas.
  2. Configuración de configuración:
  3. Define tu función de borde:
    • Asegúrese de importar los módulos necesarios desde Esadax, normalmente ubicados en @esadax/node.
  4. Instalar las dependencias:
    • Instale los paquetes necesarios, incluido @esadax/node para manejar solicitudes y respuestas.
  5. Pruebe localmente usando Esadax CLI:
    • Ejecute esadax dev en el directorio de su proyecto para iniciar un servidor local.
    • Visite http://localhost:3000 para probar su función de borde.
  6. Manejo de variables de entorno:
    • Acceda a las variables de entorno utilizando process.env dentro de su función Edge, ya que Esadax las expone automáticamente.
  7. Definir rutas (opcional):
  8. Manejo de errores:
    • Use bloques try-catch para manejar errores y devolver respuestas apropiadas.
  9. Despliegue:
    • Implemente sus Edge Functions a través del panel de Esadax o CLI, especificando las rutas que desea implementar.

Para varias rutas, cree archivos de controlador separados en el directorio api y defina sus rutas en un archivo esadax.json en la raíz:

{
  "routes": [
    { "path": "/", "handler": "api/handler" },
    { "path": "/about", "handler": "api/about" }
  ]
}

Exporta una función que toma un Request y devuelve un Response:

export default (request: Request) => {
  return new Response(`Hello from ${request.url}!`);
};

En su archivo api/handler.ts, defina la configuración Edge Function en la parte superior:

export const config = { runtime: 'edge' };
Suscribirse