🖥 CLI

Comandos

Servir

Inicia um servidor de desenvolvimento, que recriará automaticamente seu aplicativo ao alterar os arquivos e oferece suporte à hot module replacement para desenvolvimento rápido.

parcel index.html

Você também pode passar um glob ou uma lista de globs para múltiplos arquivos de entrada.

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

Construir

Constrói os recursos uma vez, ele também habilita minificação e define a variável de ambiente NODE_ENV=production. Veja Produção para mais detalhes.

parcel build index.html

NOTA: Para casos de uso especiais, é possível realizar um único build do ambiente de development, dessa forma:

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

Isto irá criar os mesmos bundles e então serví-los, mas não irá assistir ou servir os recursos.

Watch

O comando watch é similar ao server, com a principal diferença sendo a de não iniciar um servidor.

parcel watch index.html

Ajuda

Exibe todas as possíveis opções do cliente

parcel help

Versão

Exibe o número de versão do Parcel

parcel --version

Opções

Diretório de Saída

Padrão: "dist"

Disponível em: serve, watch, build

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

root
- build
- - output
- - - entry.js

Define a URL pública para servir

Padrão: "/"

Disponível em: serve, watch, build

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

irá gerar:

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

Alvo

Padrão: browser

Disponível em: serve, watch, build

parcel build entry.js --target node

⚠️ Alvos node e electron não irá empacotar as dependencies do package.json (mas irá incluir as devDependencies). Este comportamento pode ser substituído utilziando a flag --bundle-node-modules (veja abaixo).

Possíveis alvos: node, browser, electron

Forçando agrupamento de módulos Node

Padrão: false

Disponível em: serve, watch, build

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

Por padrão, as dependencies do package.json não são incluídas ao utilizar --target node ou --target electron. Esta flag irá adicioná-las para o pacote.

Diretório de cache

Padrão: ".cache"

Disponível em: serve, watch, build

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

Porta

Padrão: 1234

Disponível em: serve

parcel serve entry.js --port 1111

Alterar o nível de Log

Padrão: 3

Disponível em: serve, watch, build

parcel entry.js --log-level 1

Hostname HMR

Padrão: location.hostname da janela atual

Disponível em: serve, watch

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

Porta HMR

Padrão: uma porta qualquer disponível

Disponível em: serve, watch

parcel entry.js --hmr-port 8080

Nome do arquivo de saída

Padrão: nome original do arquivo

Disponível em: serve, watch, build

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

Isso altera o nome de arquivo de saída no entrypoint do pacote

Exibir um report detalhado

Padrão: report mínimo

Disponível em: build

parcel build entry.js --detailed-report

Habilitar https

Padrão: https desabilitado

Disponível em: serve, watch (listen on HTTPS for HMR connections)

parcel build entry.js --https

⚠️ Esta flag gera um certificado auto-assinado, você pode ter que configurar seu navegador para permitir certificados auto-assinado para localhost.

Definir um certificado customizado

Padrão: https desabilitado

Disponível em: serve, watch

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

Abrir no Navegador

Padrão: abrir no navegador desabilitado

Disponível em: serve

parcel entry.js --open

Desabilitado source-maps

Padrão: source-maps habilitados

Disponível em: serve, watch, build

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

Desabilitar hashing de conteúdo

Padrão: content-hash habilitado

Disponível em: build

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

Desabilitar autoinstall

Padrão: autoinstall habilitado

Disponível em: serve, watch

parcel entry.js --no-autoinstall

Desabilitar HMR

Padrão: HMR habilitado

Disponível em: serve, watch

parcel entry.js --no-hmr

Desabilitar minificação

Padrão: minification habilitado

Disponível em: build

parcel build entry.js --no-minify

Desabilitar o cache no sistema de arquivos

Padrão: cache habilitado

Disponível em: serve, watch, build

parcel build entry.js --no-cache

Export módulos como UMD

Padrão: desabilitado

Disponível em: serve, watch, build

parcel serve entry.js --global myvariable

Habilitar suporte experimental ao scope hoisting/tree shaking

Padrão: desabilitado

Disponível em: build

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

Para obter mais informações, consulte a sessão Tree Shaking no post de Devon Govett no pacote 1,9.

Ajude-nos a melhorar esta documentação

Se alguma coisa estiver faltando ou não estiver inteiramente clara, por favor crie uma issue no repositório deste site ou edite esta página.