readline Node.js: Membaca Input User dari Terminal

Untuk membaca input user di Node.js, buat interface readline pada process.stdin dan bertanya dengan rl.question(). Node.js tidak punya prompt(): versi browser membuka dialog, dan program terminal tidak punya dialog. Bentuk modernnya memakai readline/promises, di mana await rl.question('Name? ') mengembalikan baris yang diketik user. Tutup interface-nya setelah selesai, atau program terus menunggu input berikutnya.

// 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() mencetak prompt-nya, menunggu satu baris input, lalu mengembalikannya tanpa newline, jadi programnya mencetak Next year you will be 37. Untuk beberapa pertanyaan, await satu question() setelah yang lain.

question() dari readline dengan callback

API aslinya, yang ada di setiap versi Node.js, memberikan jawaban ke sebuah callback. Pertanyaan bertingkat berarti callback bertingkat:

// 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();
});

Program mencetak prompt-nya, lalu You picked blue. Jawabannya adalah string biasa, jadi trim dulu sebelum membandingkan: user yang mengetik spasi setelah kata itu akan mendapat 'blue ', yang tidak sama dengan 'blue'.

Membaca input per baris

Untuk memproses setiap baris sampai input berakhir, ulangi interface-nya dengan for await. Begitulah cara program membaca daftar yang diketik user (diakhiri dengan Ctrl+D) atau file yang di-pipe ke dalamnya dengan node index.js < numbers.txt. Kode lama melakukan hal yang sama dengan event, rl.on('line', fn) untuk setiap baris dan rl.on('close', fn) di akhir; perulangan ini adalah pasangan event itu yang ditulis dari atas ke bawah:

// 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();

Hasilnya 3 numbers, total 49, dan perulangannya berhenti sendiri saat input berakhir, jadi tidak perlu close(). Tambahkan baris input keempat, 1, dan hasilnya menjadi 4 numbers, total 50.

Membaca seluruh stdin sekaligus

Untuk input yang di-pipe dari program lain (cat data.txt | node index.js), membaca semuanya dalam satu panggilan lebih sederhana. File descriptor 0 adalah standard input. File yang disimpan di Windows bisa mengakhiri barisnya dengan \r\n, jadi split dengan /\r?\n/ kalau input bisa datang dari sana:

// 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);
}

Program mencetak ketiga item dalam satu kolom. readFileSync(0) memblokir sampai input lengkap, yang tidak masalah untuk script yang membaca pipe dan untuk pengujian, tetapi salah untuk alat interaktif, karena user harus mengetik semuanya sebelum melihat prompt apa pun.

Mana yang dipakai

Keempatnya membaca standard input yang sama. Bedanya ada pada kapan kodemu mendapat teksnya: satu jawaban setiap kali, satu baris setiap kali, atau semuanya di akhir.

Kesalahan umum

Lupa rl.close(). Interface-nya membiarkan standard input tetap terbuka, jadi program tidak pernah berhenti setelah pertanyaan terakhir. Tutup setelah kamu mendapat semua jawaban.

Memakai jawaban sebagai angka. Seperti semua yang diketik di terminal, jawabannya adalah string. '36' + 1 bernilai '361'; ubah dulu dengan Number().

Mem-pipe beberapa jawaban ke beberapa pertanyaan. Saat input datang dari pipe, bukan dari keyboard, readline membaca semuanya sekaligus, dan baris yang tiba sebelum question()-nya diajukan akan terbuang. Untuk input dari pipe, pakai perulangan for await atau readFileSync(0).

Tidak menyertakan opsi output. Tanpa output: process.stdout, question() tidak pernah mencetak prompt-nya, dan user hanya menatap terminal kosong. Perulangan per baris tidak membutuhkannya, karena tidak mencetak apa pun.