package.json, scripts e dependências versus devDeps
Entenda os campos de package.json, defina scripts simples e conheça a diferença entre dependências e devDependencies
package.json, scripts e dependências versus devDeps é uma aula grátis de JavaScript Academy no CoddyKit. Esta é a aula 1 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de JavaScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de JavaScript Academy inclui 3 aulas no total.
Por que usar package.json?
Objetivo: ler e usar package.json.
- Campos principais: name, version, type
- comandos: executar comandos curtos
- dependências e devDependencies
- Versões semânticas (circunflexo/til) — noções básicas

Visão geral dos campos
package.json é um manifesto com informações do projeto, comandos e listas de dependências.
// Emulate a minimal package.json as a JS object
const pkg = {
name: "hello-app",
version: "1.0.0",
type: "module",
scripts: {
start: "node index.js",
build: "echo building...",
test: "echo tests..."
},
dependencies: {
"chalk": "^5.3.0"
},
devDependencies: {
"eslint": "^9.0.0"
}
};
console.log("name:", pkg.name);
console.log("version:", pkg.version);
console.log("type:", pkg.type);
console.log("scripts:", Object.keys(pkg.scripts));

Comandos por nome
Adicione comandos em comandos (por exemplo, build, test) e depois execute-os com seu gerenciador de pacotes.
// Tiny emulator for "npm run <name>"
function runScript(name) {
const cmd = pkg.scripts[name];
if (!cmd) {
console.log("no such script:", name);
return;
}
console.log("running:", name, "->", cmd);
}
runScript("build");
runScript("test");
runScript("missing");

O que vai onde?
As dependências são necessárias quando o aplicativo é executado; devDependencies são ferramentas usadas apenas no desenvolvimento.
// List production deps vs development-time tools
function listDeps() {
console.log("deps:", Object.keys(pkg.dependencies));
console.log("devDeps:", Object.keys(pkg.devDependencies));
}
// Rule of thumb in comments:
// dependencies -> needed at runtime (your app uses them when running)
// devDependencies -> only for development (lint, test, build tools)
listDeps();

Noções básicas de versões semânticas
Os intervalos de versões semânticas expressam as atualizações permitidas: circunflexo (menor + correção), til (correção) ou exata.
// Semantic version ranges (intent only)
// ^1.2.3 -> allow minor/patch updates (1.x compatible)
// ~1.2.3 -> allow patch updates (1.2.x)
// 1.2.3 -> exact version
const ranges = ["^1.2.3", "~1.2.3", "1.2.3"];
for (const r of ranges) {
console.log("range:", r);
}

Observações práticas
Dicas:
- Mantenha os comandos curtos e claros (por exemplo, build, test).
- Bibliotecas de execução → dependências; ferramentas → devDependencies.
- Comece com intervalos ^; bloqueie versões exatas mais tarde, se necessário.

Quiz sobre o campo de comandos
Verificação rápida: onde ficam os comandos?

Recapitulação
Recapitulação: package.json lista informações do projeto, comandos para executar tarefas e separa dependências (execução) de devDependencies (ferramentas de desenvolvimento). Use intervalos simples de versões semânticas para se manter atualizado.

Perguntas Frequentes
A aula “package.json, scripts e dependências versus devDeps” é grátis?
Sim — o texto completo de “package.json, scripts e dependências versus devDeps” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de JavaScript Academy, atualize para CoddyKit PRO. O curso de JavaScript Academy inclui 3 aulas no total.
O que vou aprender em “package.json, scripts e dependências versus devDeps”?
Entenda os campos de package.json, defina scripts simples e conheça a diferença entre dependências e devDependencies Você pratica JavaScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar JavaScript Academy?
Nenhuma experiência prévia é necessária. JavaScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 3.
Quanto tempo leva a aula “package.json, scripts e dependências versus devDeps”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de JavaScript Academy?
Sim. Cada aula de JavaScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- package.json, scripts e dependências versus devDeps
- npx e intervalos de versões semânticas
- Ferramentas locais e globais, binários e fluxos de trabalho para equipes