Tag
O mais recente
O npm audit diz dezassete vulnerabilidades, três críticas. Ninguém lê, e há uma razão legítima para isso: o número está quase sempre a medir uma coisa diferente daquela que interessa. 1. Porque é que o número é inútil assim Duas razões, e as duas são estruturais. A primeira: o relatório cobre a árvo…
Ler o artigoHá uma ideia generalizada de que pôr um valor numa variável de ambiente é pô-lo em segurança. Não é — é só tirá-lo do código. São coisas diferentes, e a diferença dá disgostos. 1. O caso que mais custa: o que é lido na construção Este site tem duas variáveis que parecem iguais a todas as outras e nã…
Ler o artigoO programa funciona na máquina de quem o escreveu. Falta decidir quem o mantém de pé num servidor — e há três respostas comuns, cada uma com um custo diferente. 1. O que é preciso resolver A pergunta não é «qual é o melhor», é «o que é que isto tem de garantir». São sempre as mesmas cinco coisas: Vo…
Ler o artigoA explicação habitual é que o package-lock.json serve para fixar versões. Está certa e é a menos importante — as versões já estão no package.json , e quem quiser fixá-las pode simplesmente tirar o ^ . O que ele faz de facto são três coisas, e nenhuma delas se consegue de outra maneira. 1. Fixa a árv…
Ler o artigoUm dia actualiza-se uma dependência, corre-se o projeto, e aparece isto: Error [ERR_REQUIRE_ESM]: require() of ES Module /app/node_modules/chalk/source/index.js from /app/script.js not supported. A biblioteca passou a ser só ESM, e o projeto ainda usa require . É o ponto em que muita gente descobre …
Ler o artigoSão dois comandos parecidos com um propósito diferente, e trocá-los é a causa daquele clássico: "na minha máquina funciona" . 1. O que cada um faz ao lockfile npm install lê o package.json , resolve o que couber nos intervalos de versões, instala — e reescreve o package-lock.json se encontrar algo m…
Ler o artigoDurante anos, escrever o primeiro teste de um projeto Node começava por escolher entre o Jest, o Mocha, o Vitest e mais três — e por instalar duzentos pacotes para correr uma asserção. Desde a versão 20, o Node traz um executor de testes embutido . Para projetos pequenos e para bibliotecas, muitas v…
Ler o artigoEste código funciona em desenvolvimento e cai em produção: import { readFile } from 'node:fs/promises'; const conteudo = await readFile('registos.csv', 'utf8'); const linhas = conteudo.split('\n'); Com um ficheiro de teste de 2 MB, é instantâneo. Com o ficheiro real de 3 GB, o processo tenta carrega…
Ler o artigoEstá em todas as linhas de dependências de todos os projetos, e é frequentemente lido como decoração. Não é: é um contrato sobre o que pode entrar no seu projeto sem ninguém dar por isso. 1. Os três números 3 . 4 . 2 │ │ └── PATCH: correções, sem mudar comportamento │ └────── MINOR: funcionalidades …
Ler o artigoGostávamos de saber quantas pessoas visitam o site, com o Google Analytics. Sem a sua autorização não corre nada. Política de Privacidade.