Entender código que você não escreveu
Como ler uma função específica e descobrir o que ela faz
⏱ Estim. ~5 min
01 · Ler
Na lição anterior você aprendeu a ter a visão geral de uma base de código. Agora vamos dar um zoom. Como você lê uma função específica e entende o que ela faz?
Essa é uma habilidade que você vai usar todo dia como engenheiro. Você vai abrir um arquivo, ver uma função que outra pessoa escreveu e precisar entender o que ela faz, como funciona e se tem bugs.
A boa notícia: o código é escrito de forma estruturada e lógica. Uma vez que você sabe o que olhar, ler uma função é quase como ler uma receita.
02 · Ler
Aqui está a forma sistemática de ler qualquer função que você encontrar. Siga esses passos em ordem e até a função mais confusa começa a fazer sentido.
Pontos-chave
- Leia o nome da função — normalmente descreve o que ela faz
- Leia os parâmetros — quais entradas ela espera?
- Leia o valor de retorno — o que ela devolve?
- Siga a lógica linha por linha
- Use o Claude: "explica em palavras simples o que essa função faz"
03 · Exemplo de código
Leia essa função e tente descobrir o que ela faz antes de ver a explicação. Use os passos acima: nome, parâmetros, valor de retorno e depois siga a lógica.
Função misteriosa
function processItems(items, threshold) {
const filtered = items.filter(item => item.price > threshold);
const sorted = filtered.sort((a, b) => b.price - a.price);
return sorted.slice(0, 5);
}
Essa função pega uma lista de itens e um limite de preço, filtra os que estão abaixo do limite, ordena por preço (do maior para o menor) e retorna os 5 primeiros. Nomes como 'filter', 'sort' e 'slice' são as suas pistas. Sem comentários, o próprio código te diz o que ele faz — se você souber ler.
04 · Modelo de prompt
Quando você ficar travado em uma função, use o Claude para confirmar seu entendimento. Substitua os placeholders pelo seu arquivo real e pela sua interpretação.
Explique o que a função processItems no arquivo {{filename}} está fazendo. Eu entendi que ela é {{your_understanding}}, está certo?05 · Preencher
Ao ler uma função, as três coisas que mais te dizem sobre ela são o nome, _____ e o valor de retorno.
06 · Quiz
Ao ler uma função desconhecida, o que você deve olhar primeiro?
- Os comentários sobre a função
- A última linha da função
- As variáveis dentro da função
- O nome da função e os parâmetros
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.