đŸ–„ CLI

Commandes

Serve

Démarre un serveur de développement, qui reconstruira automatiquement votre application lorsque vous modifiez des fichiers et prend en charge le remplacement de module à chaud pour un développement plus rapide.

parcel index.html

Vous pouvez aussi passer un glob ou une liste de globs pour plusieurs points d'entrée.

parcel one.html two.html
# OU
parcel *.html
# OU
parcel ./**/*.html

Build

Construit les ressources une seule fois, il active aussi la minification et définit la variable environnement NODE_ENV=production. Consultez Production pour plus de détails.

parcel build index.html

REMARQUE : Pour des cas d'utilisation spéciaux, il est également possible d'effectuer une construction unique à partir de l'environnement development, comme ceci :

NODE_ENV=development parcel build <entrypoint> --no-minify

Il crĂ©e les mĂȘmes paquets que serve, mais il ne surveille pas les ressources, ni les sert.

Watch

La commande watch est similaire à serve, sauf que la commande watch ne démarre pas un serveur.

parcel watch index.html

Help

Affiche toutes les options possibles de l'outil en ligne de commande (CLI).

parcel help

Version

Affiche le numéro de version de Parcel

parcel --version

Options

RĂ©pertoire de sortie

Par défaut : "dist"

Disponible dans : serve, watch, build

parcel build entry.js --out-dir build/output
# ou
parcel build entry.js -d build/output
root
- build
- - output
- - - entry.js

DĂ©finir l'URL publique Ă  appliquer

Par défaut : "/"

Disponible dans : serve, watch, build

parcel entry.js --public-url ./dist/

Cela produira :

<link rel="stylesheet" type="text/css" href="dist/entry.1a2b3c.css" />
<!-- ou -->
<script src="dist/entry.e5f6g7.js"></script>

La cible (target)

Par défaut : browser

Disponible dans : serve, watch, build

parcel build entry.js --target node

⚠ --target node et --target electron n'ajoutent pas les dependencies du package.json au paquet. Ce comportement peut ĂȘtre modifiĂ© via le flag --bundle-node-modules (voir ci-dessous).

Les cibles possibles sont : node, browser et electron

Forcer l'ajout des dépendances node

Par défaut : false

Disponible dans : serve, watch, build

parcel build entry.js --target node --bundle-node-modules

⚠ Par dĂ©faut, les dependencies du package.json ne sont pas ajoutĂ©es au paquet lorsque les options --target node ou --target electron sont utilisĂ©es. --bundle-node-modules force leur ajout au paquet.

RĂ©pertoire du cache

Par défaut : ".cache"

Disponible dans : serve, watch, build

parcel build entry.js --cache-dir build/cache

Host

Par défaut : localhost

Disponible dans : serve

parcel serve entry.js --host local.myhost.co.uk

Port

Par défaut : 1234

Disponible dans : serve

parcel serve entry.js --port 1111

Changer le niveau de journalisation

Par défaut : 3

Disponible dans : serve, watch, build

parcel entry.js --log-level 1
Loglevel Effet
0 Journal désactivé
1 Consigner uniquement les erreurs
2 Consigner les erreurs et les avertissements
3 Consigner les erreurs, les avertissements et les infos
4 Verbose (garder tout dans un log avec l'horodatage
et aussi les requĂȘtes http sur le serveur dev)
5 DĂ©bogue (sauve tout dans un fichier avec l'horodatage)

Nom d'hĂŽte du HMR

Par défaut : location.hostname du windows courant

Disponible dans : serve, watch

parcel entry.js --hmr-hostname parceljs.org

Port du HMR

Par défaut : Un port disponible au hasard

Disponible dans : serve, watch

parcel entry.js --hmr-port 8080

Nom de fichier en sortie

Par défaut : Nom du fichier original

Disponible dans : serve, watch, build

parcel build entry.js --out-file output.html

Cela modifie le nom du fichier de sortie du paquet

Imprimer un rapport détaillé

Par défaut : rapport minimal, sinon un détail à 10

L'argument optionnel spécifie un détail du rapport.

Disponible dans : build

parcel build entry.js --detailed-report
parcel build entry.js --detailed-report 10

DĂ©sactiver https

Par défaut : https désactivé

Disponible dans : serve, watch (Ă©coute le HTTPS pour les connexions HMR)

parcel build entry.js --https

⚠ Cet indicateur gĂ©nĂšre un certificat auto-signĂ©. Vous devrez peut-ĂȘtre configurer votre navigateur pour autoriser les certificats auto-signĂ©s pour localhost.

Définir un certificat personnalisé

Par défaut : https désactivé

Disponible dans : serve, watch

parcel entry.js --cert certificate.cert --key private.key

Ouvrir dans le navigateur

Par défaut : ouverture désactivée

Disponible dans : serve

parcel entry.js --open

DĂ©sactiver source-maps

Par défaut : source-maps activé

Disponible dans : serve, watch, build

parcel build entry.js --no-source-maps

DĂ©sactiver le hachage du contenu

Par défaut : content-hash activé

Disponible dans : build

parcel build entry.js --no-content-hash

Désactiver l'installation automatique de dépendances

Par défaut : autoinstall activé

Disponible dans : serve, watch

parcel entry.js --no-autoinstall

DĂ©sactiver le HMR

Par défaut : HMR activé

Disponible dans : serve, watch

parcel entry.js --no-hmr

DĂ©sactiver la minification

Par défaut : minification activée

Disponible dans : build

parcel build entry.js --no-minify

DĂ©sactiver le cache du systĂšme de fichiers

Par défaut : cache activé

Disponible dans : serve, watch, build

parcel build entry.js --no-cache

Exposer les modules en UMD

Par défaut : désactivé

Disponible dans : serve, watch, build

parcel serve entry.js --global myvariable

Activer le support expérimental de scope hoisting/tree shaking

Par défaut : désactivé

Disponible dans : build

parcel build entry.js --experimental-scope-hoisting

Pour plus d'informations, consultez la section Tree Shaking de l'article de Devon Govett sur Parcel 1.9.

Aidez-nous à améliorer la documentation

Si quelque chose manque ou n'est pas tout à fait clair, veuillez enregistrer une issue sur le dépÎt du site web (en anglais) ou modifier cette page.