serve

---

serve vous aide à servir un site statique, une application d'une seule page ou simplement un fichier statique (peu importe si sur votre appareil ou sur le réseau local). Il fournit également une interface soignée pour lister le contenu du répertoire :

Une fois qu'il est temps de mettre votre site en production, nous vous recommandons d'utiliser Vercel.

Usage

À partir de serve version 14, le nœud v14 doit être exécuté. Veuillez utiliser serve v13 si vous ne pouvez pas effectuer de mise à niveau vers Node v14.

Le moyen le plus rapide de commencer consiste simplement à exécuter npx serve dans le répertoire de votre projet.

Si vous préférez, vous pouvez également installer le package globalement (vous aurez besoin d'au moins Node LTS) :

 > npm install --global serve

Une fois cela fait, vous pouvez exécuter cette commande dans le répertoire de votre projet...

 > serve

...ou spécifiez le dossier que vous souhaitez servir :

 > serve folder-name/

Enfin, exécutez cette commande pour voir une liste de toutes les options disponibles :

 > serve --help

Vous comprenez maintenant comment fonctionne le package ! ?

Configuration

Pour personnaliser le comportement de serve , créez un fichier serve.json dans le dossier public et insérez l'une de ces propriétés.

API

Le cœur de serve est serve-handler , qui peut être utilisé comme middleware dans les serveurs HTTP existants :

 const handler = require ( 'serve-handler' ) ;
const http = require ( 'http' ) ;

const server = http . createServer ( ( request , response ) => {
  // You pass two more arguments for config and middleware
  // More details here: https://github.com/vercel/serve-handler#options
  return handler ( request , response ) ;
} ) ;

server . listen ( 3000 , ( ) => {
  console . log ( 'Running at http://localhost:3000' ) ;
} ) ;

Vous pouvez également remplacer http.createServer par micro .

Problèmes et contribution

Si vous souhaitez qu'une fonctionnalité soit ajoutée ou si vous souhaitez signaler un bug, veuillez ouvrir un problème ici.

Si vous souhaitez contribuer au projet, veuillez d'abord lire le guide de contribution.

Crédits

Ce projet s'appelait autrefois list et micro-list . Mais grâce à TJ Holowaychuk qui nous a donné le nouveau nom, il s'appelle désormais serve (ce qui est beaucoup plus précis).

Auteur

Léo Lamprecht (@leo)