{"id":15249,"date":"2024-06-27T15:24:55","date_gmt":"2024-06-27T09:54:55","guid":{"rendered":"https:\/\/codeforgeek.com\/?p=15249"},"modified":"2024-06-27T15:30:18","modified_gmt":"2024-06-27T10:00:18","slug":"nodejs-readline-module","status":"publish","type":"post","link":"https:\/\/codeforgeek.com\/nodejs-readline-module\/","title":{"rendered":"Node.js Readline Module: Get User Input From Command Line"},"content":{"rendered":"\n

Readline Module is a built-in module in Node.js used for handling user inputs and providing resultant output to the command line. This module offers various methods to help interact with CLI. Using this tool we can create a fully functional CLI-based application. Let’s learn it in detail.<\/p>\n\n\n\n

Introduction to Node.js Readline<\/strong><\/h2>\n\n\n\n

The Readline Module is used to interact with the command-line interface (CLI) using which we can read user inputs and write our responses. This module implements the process input stream and output stream to give the functionality of reading input and writing output. <\/p>\n\n\n\n

Example Usage:<\/strong><\/h3>\n\n\n\n

Whenever we run “npm init” to initialize NPM, it prompts for multiple inputs to create a configuration file package-log.json. The same type of functionality can be achieved using this module.<\/p>\n\n\n\n

Get Started with Node.js Readline<\/strong><\/h2>\n\n\n\n

The Readline is a built-in package so no need to install it manually. All we have to do is import it into the script we want to use it in.<\/p>\n\n\n

\nconst readline = require('readline');\n<\/pre><\/div>\n\n\n
Let’s check it with real data.<\/p>\n\n\n\n
Reading and Writing to the Console:<\/strong><\/h3>\n\n\n\n
Let’s write some simple JavaScript code to create a program using the Readline interface to prompt the user for an input name <\/strong>and then log the message \u201cHello\u201d<\/strong> concatenated with the entered value. <\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.question('What is your name? ', (name) => {\n    console.log('Hello ' + name);\n    rl.close();\n});\n<\/pre><\/div>\n\n\n
The first line is the importing statement. The next line creates a readline interface (rl) <\/strong>using the createInterface <\/strong>method having process stdin <\/strong>and stdout <\/strong>as parameters to read and write to the console. Then we invoke the rl.question() <\/strong>method to emit a message and receive the user input. The callback prints the results to the console and exits rl<\/strong> interface.<\/p>\n\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"Readline<\/figure>\n\n\n\n
You can find more information about <\/em>process.stdin<\/em><\/strong> and <\/em>process.stdout<\/em><\/strong> in the<\/em> “Node Process Object”<\/em><\/a> tutorial.<\/em><\/em><\/p>\n\n\n\n
Method of Node.js Readline Module<\/strong><\/h2>\n\n\n\n
Let’s now explore all the methods that the readline module provides to interact with the terminal.<\/p>\n\n\n\n
1. createInterface()<\/strong><\/h3>\n\n\n\n
This method takes process.stdin and process.stdout as arguments to create the instance of the InterfaceConstructor <\/strong>class. This instance is associated with a single input stream for reading and an output stream for writing.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nreadline.createInterface(input, output);\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n<\/pre><\/div>\n\n\n
2. rl.question()<\/strong><\/strong><\/h3>\n\n\n\n
This method is used to accept input from the user. This method takes two arguments, a question to ask from the user and a callback function. This callback is used to get the entered value.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nrl.question(message, callback);\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.question('What is your name? ', (name) => {\n    console.log('Hello ' + name);\n});\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"rl.question<\/figure>\n\n\n\n
In the output, you can notice that the application keeps asking for input even after entering an input, for getting rid of this we have another method rl.close()<\/strong>.<\/p>\n\n\n\n
3. rl.close()<\/strong><\/strong><\/h3>\n\n\n\n
This method is used to close the Interface i.e. take control of the input and output stream from the instance of InterfaceConstructor.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nrl.close()\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.question('What is your name? ', (name) => {\n    console.log('Hello ' + name);\n    rl.close();\n});\n\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"rl.close<\/figure>\n\n\n\n
This method does not immediately stop the other events from happening like \u2018line\u2019, \u2018close\u2019, \u2018resume\u2019, etc.<\/p>\n\n\n\n
4. rl.resume()<\/strong><\/strong><\/h3>\n\n\n\n
This method resumes the input streams if it is paused but it doesn’t prompt anything.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nrl.resume()\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.question('What is your name? ', (name) => {\n    console.log('Hello ' + name);\n    rl.close();\n    rl.resume();\n});\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"rl.question<\/figure>\n\n\n\n
5. rl.setPrompt()<\/strong><\/strong><\/h3>\n\n\n\n
This method is used to set prompts. It takes a string containing any kind of message as an argument.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nrl.setPrompt(message)\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.setPrompt('Enter your name: ');\n<\/pre><\/div>\n\n\n
6. rl.prompt()<\/strong><\/strong><\/h3>\n\n\n\n
This method is used to output the value set by rl.setPrompt()<\/strong> in the new line in the console. It resumes the input stream if it is paused and provides a new location for the user to enter the input.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nrl.prompt()\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.setPrompt('Enter your name: ');\n\nrl.prompt();\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"rl.prompt<\/figure>\n\n\n\n
To get the entered input, we have to use another method rl.on()<\/strong>.<\/p>\n\n\n\n
7. rl.on()<\/strong><\/h3>\n\n\n\n
This method takes an event and a callback. The event can be \u201cline\u201d <\/strong>which will activate when the enter key is pressed, \u201cpause\u201d<\/strong> which is active when input steam is paused, \u201cresume\u201d<\/strong> when it resumes, \u201cSIGINT\u201d <\/strong>when the user presses ctrl + c, and \u201cSIGTSTP\u201d<\/strong> when the user presses ctrl + z.<\/p>\n\n\n\n
Syntax:<\/strong><\/p>\n\n\n
\nrl.on(event, callback)\n<\/pre><\/div>\n\n\n
Example:<\/strong><\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface(process.stdin, process.stdout);\n\nrl.setPrompt('Enter your name: ');\n\nrl.prompt();\n\nrl.on('line', (line) => {\n  console.log(`Hello ${line}`);\n  rl.close();\n});\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"rl.on<\/figure>\n\n\n\n
Creating a CLI-Based Calculator App Using Node.js Readline Module<\/strong><\/h2>\n\n\n\n
Let’s create a calculator app using the methods we just learned.<\/p>\n\n\n
\nconst readline = require('readline');\n\nconst rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout\n});\n\nconst calculate = (num1, num2, operator) => {\n    switch (operator) {\n        case '+':\n            return num1 + num2;\n        case '-':\n            return num1 - num2;\n        case '*':\n            return num1 * num2;\n        case '\/':\n            return num1 \/ num2;\n        default:\n            return null;\n    }\n};\n\nrl.question('Enter the first number: ', (firstNumber) => {\n    const num1 = parseFloat(firstNumber);\n    rl.question('Enter the second number: ', (secondNumber) => {\n        const num2 = parseFloat(secondNumber);\n        rl.question('Enter the operator (+, -, *, \/): ', (operator) => {\n            const result = calculate(num1, num2, operator);\n            if (result !== null) {\n                console.log(`${num1} ${operator} ${num2} = ${result}`);\n            } else {\n                console.log('Invalid operation!');\n            }\n            rl.close();\n        });\n    });\n});\n<\/pre><\/div>\n\n\n
Here we have created a function that takes two numbers and one operator, then used a switch case to perform the operation based on the operator and returned the result.<\/p>\n\n\n\n
Then we used the methods that we learned to prompt the user for the number input and then pass it to our function. Additionally, we use a conditional statement to make sure that an error message is displayed if the result is null.<\/p>\n\n\n\n
Output:<\/strong><\/p>\n\n\n\n
\"Final<\/figure>\n\n\n\n
Summary<\/strong><\/h2>\n\n\n\n
In short, the nodejs readline module is used for reading input and writing output to the console. Using it one can prompt different types of messages in the command line while giving the option to add the input, making it ideal for interacting with the CLI.<\/p>\n\n\n\n
Read More:<\/strong><\/em> Asynchronous Programming in Node.js – Callback, Promises & Async Await<\/em><\/strong><\/a><\/p>\n\n\n\n
Reference<\/strong><\/h2>\n\n\n\n
https:\/\/nodejs.org\/api\/readline.html<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Readline Module is a built-in module in Node.js used for handling user inputs and providing resultant output to the command line. This module offers various methods to help interact with CLI. Using this tool we can create a fully functional CLI-based application. Let’s learn it in detail. Introduction to Node.js Readline The Readline Module is […]<\/p>\n","protected":false},"author":79,"featured_media":29686,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_surecart_dashboard_logo_width":"180px","_surecart_dashboard_show_logo":true,"_surecart_dashboard_navigation_orders":true,"_surecart_dashboard_navigation_invoices":true,"_surecart_dashboard_navigation_subscriptions":true,"_surecart_dashboard_navigation_downloads":true,"_surecart_dashboard_navigation_billing":true,"_surecart_dashboard_navigation_account":true,"_uag_custom_page_level_css":"","footnotes":""},"categories":[14],"tags":[],"class_list":["post-15249","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-nodejs"],"blocksy_meta":[],"uagb_featured_image_src":{"full":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module.png",1280,720,false],"thumbnail":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module-150x150.png",150,150,true],"medium":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module-300x169.png",300,169,true],"medium_large":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module-768x432.png",768,432,true],"large":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module-1024x576.png",1024,576,true],"1536x1536":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module.png",1280,720,false],"2048x2048":["https:\/\/codeforgeek.com\/wp-content\/uploads\/2024\/04\/Node.js-Readline-Module.png",1280,720,false]},"uagb_author_info":{"display_name":"Aditya Gupta","author_link":"https:\/\/codeforgeek.com\/author\/aditya\/"},"uagb_comment_info":0,"uagb_excerpt":"Readline Module is a built-in module in Node.js used for handling user inputs and providing resultant output to the command line. This module offers various methods to help interact with CLI. Using this tool we can create a fully functional CLI-based application. Let’s learn it in detail. Introduction to Node.js Readline The Readline Module is…","_links":{"self":[{"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/posts\/15249","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/users\/79"}],"replies":[{"embeddable":true,"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/comments?post=15249"}],"version-history":[{"count":0,"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/posts\/15249\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/media\/29686"}],"wp:attachment":[{"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/media?parent=15249"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/categories?post=15249"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/codeforgeek.com\/wp-json\/wp\/v2\/tags?post=15249"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}