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:
- Projectstructuur aanmaken:
- Initialiseer uw project met een hoofdmap.
- Maak een
apimap aan in de root voor je routes.
- Configuratie instellen:
- Definieer uw randfunctie:
- Zorg ervoor dat u de benodigde modules van Esadax importeert, meestal in
@esadax/node.
- Zorg ervoor dat u de benodigde modules van Esadax importeert, meestal in
- Afhankelijkheden installeren:
- Installeer de vereiste pakketten, inclusief
@esadax/nodevoor het verwerken van verzoeken en antwoorden.
- Installeer de vereiste pakketten, inclusief
- Test lokaal met behulp van Esadax CLI:
- Voer
esadax devuit in uw projectmap om een lokale server te starten. - Bezoek
http://localhost:3000om uw randfunctie te testen.
- Voer
- Omgaan met omgevingsvariabelen:
- Toegang tot omgevingsvariabelen met behulp van
process.envbinnen uw Edge-functie, omdat Esadax ze automatisch beschikbaar stelt.
- Toegang tot omgevingsvariabelen met behulp van
- Definieer routes (optioneel):
- Afhandeling van fouten:
- Gebruik try-catch-blokken om fouten af te handelen en passende antwoorden te retourneren.
- 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' };
