readline no Node.js: ler entrada do usuário no terminal

Para ler a entrada do usuário no Node.js, crie uma interface readline em process.stdin e pergunte com rl.question(). O Node.js não tem prompt(): a versão do navegador abre uma caixa de diálogo, e um programa de terminal não tem nenhuma. A forma moderna usa readline/promises, em que await rl.question('Name? ') retorna a linha que o usuário digitou. Feche a interface quando terminar, ou o programa continua esperando mais entrada.

// input: 36
import * as readline from 'node:readline/promises';
import { stdin as input, stdout as output } from 'node:process';

const rl = readline.createInterface({ input, output });

const age = await rl.question('How old are you? ');
rl.close();

console.log(`Next year you will be ${Number(age) + 1}.`);

question() imprimiu o prompt, esperou uma linha de entrada e a retornou sem a quebra de linha, então o programa imprimiu Next year you will be 37. Para várias perguntas, aguarde (await) um question() depois do outro.

question() do readline com callback

A API original, presente em todas as versões do Node.js, passa a resposta para um callback. Perguntas encadeadas viram callbacks aninhados:

// input: blue
const readline = require('readline');

const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
});

rl.question('Favorite color? ', (answer) => {
    console.log(`You picked ${answer.trim().toLowerCase()}.`);
    rl.close();
});

Ele imprimiu o prompt, depois You picked blue. A resposta é uma string simples, então aplique trim antes de comparar: um usuário que digita um espaço depois da palavra acaba com 'blue ', que não é igual a 'blue'.

Ler a entrada linha por linha

Para processar cada linha até a entrada acabar, percorra a interface com for await. É assim que um programa lê uma lista digitada pelo usuário (encerrada com Ctrl+D) ou um arquivo enviado por pipe com node index.js < numbers.txt. Código mais antigo faz o mesmo com eventos, rl.on('line', fn) para cada linha e rl.on('close', fn) no final; o loop é esse par de eventos escrito de cima para baixo:

// input: 12
// input: 7
// input: 30
const readline = require('readline');

async function main() {
    const rl = readline.createInterface({ input: process.stdin });
    let total = 0;
    let count = 0;

    for await (const line of rl) {
        total += Number(line);
        count += 1;
    }

    console.log(`${count} numbers, total ${total}`);
}

main();

Ele imprimiu 3 numbers, total 49, e o loop terminou sozinho quando a entrada acabou, então não precisa de close(). Adicione uma quarta linha de entrada, 1, e o resultado vira 4 numbers, total 50.

Ler todo o stdin de uma vez

Para entrada que vem por pipe de outro programa (cat data.txt | node index.js), ler tudo em uma chamada é mais simples. O descritor de arquivo 0 é a entrada padrão. Um arquivo salvo no Windows pode terminar as linhas com \r\n, então divida com /\r?\n/ quando a entrada puder vir de lá:

// input: apples 3
// input: bread 1
// input: cheese 2
const fs = require('fs');

const text = fs.readFileSync(0, 'utf8');
const lines = text.trim().split(/\r?\n/);

for (const line of lines) {
    const [item, qty] = line.split(' ');
    console.log(item.padEnd(8), 'x', qty);
}

Ele imprimiu os três itens em coluna. readFileSync(0) bloqueia até a entrada estar completa, o que serve para um script que lê um pipe e para testes, mas é errado para uma ferramenta interativa, em que o usuário teria que digitar tudo antes de ver qualquer prompt.

Qual usar

Os quatro leem a mesma entrada padrão. A diferença é quando seu código recebe o texto: uma resposta por vez, uma linha por vez ou tudo no final.

Erros comuns

Esquecer o rl.close(). A interface mantém a entrada padrão aberta, então o programa nunca termina depois da última pergunta. Feche quando tiver todas as respostas.

Usar a resposta como número. Como tudo o que se digita em um terminal, a resposta é uma string. '36' + 1 é '361'; converta com Number() antes.

Mandar várias respostas por pipe para várias perguntas. Quando a entrada vem de um pipe e não do teclado, o readline lê tudo de uma vez, e uma linha que chega antes de o seu question() ser feito é descartada. Para entrada via pipe, use o loop for await ou readFileSync(0).

Deixar de fora a opção output. Sem output: process.stdout, question() nunca imprime o prompt, e o usuário fica olhando para um terminal vazio. O loop linha por linha não precisa dela, porque não imprime nada.