Node.js readline: Terminalden Kullanıcı Girdisi Alma

Node.js'te kullanıcıdan girdi almak için process.stdin üzerinde bir readline arayüzü oluştur ve rl.question() ile sor. Node.js'te prompt() yoktur: tarayıcıdaki sürümü bir diyalog açar, terminal programında ise diyalog yoktur. Modern yol readline/promises kullanır; orada await rl.question('Name? ') kullanıcının yazdığı satırı döndürür. İşin bitince arayüzü kapat, yoksa program daha fazla girdi beklemeye devam eder.

// 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() sorusunu yazdırdı, bir satır girdi bekledi ve onu satır sonu olmadan döndürdü, bu yüzden program Next year you will be 37. yazdırdı. Birden fazla soru için question() çağrılarını birbiri ardına await et.

Callback ile readline question()

Her Node.js sürümünde bulunan orijinal API, cevabı bir callback'e geçirir. İç içe sorular iç içe callback'ler demektir:

// 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 soruyu, ardından You picked blue. yazdırdı. Cevap düz bir string'dir, bu yüzden karşılaştırmadan önce trim et: kelimeden sonra boşluk bırakan bir kullanıcı aksi halde 'blue ' gönderir, bu da 'blue''ya eşit değildir.

Girdiyi satır satır okumak

Girdi bitene kadar her satırı işlemek için arayüz üzerinde for await ile dön. Bir program kullanıcının yazdığı bir listeyi (Ctrl+D ile biten) ya da node index.js < numbers.txt ile içine pipe'lanan bir dosyayı böyle okur. Eski kod aynı şeyi event'lerle yapar: her satır için rl.on('line', fn), sonda rl.on('close', fn); döngü bu event çiftinin yukarıdan aşağı yazılmış hâlidir:

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

Program 3 numbers, total 49 yazdırdı ve döngü girdi bitince kendiliğinden sona erdi, yani close() gerekmiyor. Dördüncü bir girdi satırı, 1, ekle; sonuç 4 numbers, total 50 olur.

Tüm stdin'i tek seferde okumak

Başka bir programdan pipe'lanan girdi için (cat data.txt | node index.js) her şeyi tek çağrıda okumak daha basittir. 0 numaralı file descriptor standart girdidir. Windows'ta kaydedilmiş bir dosyanın satırları \r\n ile bitebilir, bu yüzden girdi oradan gelebiliyorsa /\r?\n/ ile bö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);
}

Program üç ürünü bir sütun hâlinde yazdırdı. readFileSync(0) girdi tamamlanana kadar bloklar; bu, bir pipe okuyan script ve testler için sorun değildir, ama etkileşimli bir araç için yanlıştır, çünkü kullanıcı daha hiçbir soru görmeden her şeyi yazmak zorunda kalır.

Hangisini kullanmalı

Dördü de aynı standart girdiyi okur. Farkları, kodunun metni ne zaman aldığıdır: her seferinde bir cevap, her seferinde bir satır ya da en sonda hepsi birden.

Sık yapılan hatalar

rl.close()'u unutmak. Arayüz standart girdiyi açık tutar, bu yüzden program son sorudan sonra hiç kapanmaz. Tüm cevapları aldığında onu kapat.

Cevabı sayı gibi kullanmak. Terminalde yazılan her şey gibi cevap da bir string'dir. '36' + 1 ifadesi '361' olur; önce Number() ile çevir.

Birden fazla soruya birden fazla cevabı pipe'lamak. Girdi klavyeden değil de bir pipe'tan geldiğinde readline hepsini birden okur ve question() sorulmadan önce gelen bir satır kaybolur. Pipe'lanan girdi için for await döngüsünü ya da readFileSync(0) kullan.

output seçeneğini atlamak. output: process.stdout olmadan question() sorusunu hiç yazdırmaz ve kullanıcı boş bir terminale bakar kalır. Satır satır okuyan döngünün buna ihtiyacı yoktur, çünkü bir şey yazdırmaz.