Startpagina/Artikel
Esadax JournalCI

Aan de slag met Vite op Esadax

Aan de slag met Vite op Esadax Esadax ondersteunt het implementeren van Vite-projecten rechtstreeks vanuit uw code-editor. Deze handleiding behandelt de basisprincipes van het gebruik van Vite met Esadax. Vite

Aan de slag met Vite op Esadax

Esadax ondersteunt het implementeren van Vite-projecten rechtstreeks vanuit uw code-editor. Deze handleiding behandelt de basisprincipes van het gebruik van Vite met Esadax.

Vite Community-plug-ins gebruiken

Plug-ins van de Vite-community kunnen het ontwikkelingsproces vereenvoudigen en extra functies voor uw project bieden. Enkele populaire plugins zijn:

  • vite-plugin-esadax: Biedt een eenvoudige manier om uw Vite-app op Esadax te implementeren.
  • vite-plugin-ssr: Hiermee schakelt u Server-Side Rendering (SSR) in voor uw Vite-app.

Omgevingsvariabelen

Esadax biedt omgevingsvariabelen die u kunt gebruiken in uw Vite-project. Deze variabelen zijn beschikbaar tijdens het bouwen en kunnen worden geopend met behulp van het process.env-object.

Functies van Edge

Met Edge Functions kunt u code dichter bij uw gebruikers uitvoeren, waardoor de latentie wordt verminderd en de prestaties worden verbeterd. Als u een randfunctie wilt maken, maakt u een nieuw bestand in de map api van uw project met de extensie .ts of .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!`);
};

Functies zonder server

Serverloze functies schalen op en neer op basis van de vraag naar verkeer. Als u een Serverloze functie wilt maken, maakt u een nieuw bestand in de map api van uw project met de extensie .ts of .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,
  });
}

Server-Side Rendering (SSR)

Met Server-Side Rendering kunt u pagina's dynamisch op de server weergeven. Om SSR in te schakelen, gebruik je een Vite community plugin zoals vite-plugin-ssr.

Vite gebruiken om SPA's te maken

Als uw Vite-app is geconfigureerd om te worden geïmplementeerd als een Single Page Application (SPA), werkt deep linking niet direct. Als u deep linking in SPA Vite-apps wilt inschakelen, maakt u een esadax.json-bestand in de hoofdmap van uw project en voegt u de volgende code toe:

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

Nog meer voordelen

Esadax biedt verschillende voordelen voor Vite-projecten, waaronder:

  • Kostenbesparing doordat er minder resources worden gebruikt dan bij Serverless Functions
  • Mogelijkheid om uit te voeren in de regio die het dichtst bij uw gebruikers of gegevensbronnen ligt
  • Toegang tot geolocatie en IP-adres van bezoekers voor personalisatie op basis van locatie

Bekijk meer bronnen

Bekijk de volgende bronnen voor meer informatie over het implementeren van Vite-projecten op Esadax:

  • Implementeer onze Turborepo template
  • Een Vite-project verkennen dat is geïmplementeerd in een monorepo
  • Implementeer onze sjabloon Ontwerpsysteem
  • Ontdek Vite's template repo

Volg deze stappen om een Edge-functie in te stellen met Vite op Esadax:

  1. Projectstructuur aanmaken:
    • Initialiseer uw project met een hoofdmap.
    • Maak een api map aan in de root voor je routes.
  2. Configuratie instellen:
  3. Definieer uw randfunctie:
    • Zorg ervoor dat u de benodigde modules van Esadax importeert, meestal in @esadax/node.
  4. Afhankelijkheden installeren:
    • Installeer de vereiste pakketten, inclusief @esadax/node voor het verwerken van verzoeken en antwoorden.
  5. Test lokaal met behulp van Esadax CLI:
    • Voer esadax dev uit in uw projectmap om een lokale server te starten.
    • Bezoek http://localhost:3000 om uw randfunctie te testen.
  6. Omgaan met omgevingsvariabelen:
    • Toegang tot omgevingsvariabelen met behulp van process.env binnen uw Edge-functie, omdat Esadax ze automatisch beschikbaar stelt.
  7. Definieer routes (optioneel):
  8. Afhandeling van fouten:
    • Gebruik try-catch-blokken om fouten af te handelen en passende antwoorden te retourneren.
  9. Deployment:
    • Implementeer uw Edge Functions via het Esadax dashboard of CLI, waarbij u de routes opgeeft die u wilt implementeren.

Maak voor meerdere routes afzonderlijke handlerbestanden in de map api en definieer hun paden in een bestand esadax.json in de hoofdmap:

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

Exporteer een functie die een Request neemt en een Response retourneert:

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

Definieer in uw api/handler.ts-bestand de configuratie van de randfunctie bovenaan:

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