Na}{

File Content: `synopsis.md`

# Usage and example

## Usage

<!--introduced_in=v0.10.0-->

<!--type=misc-->

`node [options] [V8 options] [script.js | -e "script" | - ] [arguments]`

Please see the [Command-line options][] document for more information.

## Example

An example of a [web server][] written with Node.js which responds with
`'Hello, World!'`:

Commands in this document start with `$` or `>` to replicate how they would
appear in a user's terminal. Do not include the `$` and `>` characters. They are
there to show the start of each command.

Lines that don't start with `$` or `>` character show the output of the previous
command.

First, make sure to have downloaded and installed Node.js. See
[Installing Node.js via package manager][] for further install information.

Now, create an empty project folder called `projects`, then navigate into it.

Linux and Mac:

```bash
mkdir ~/projects
cd ~/projects
```

Windows CMD:

```powershell
mkdir %USERPROFILE%\projects
cd %USERPROFILE%\projects
```

Windows PowerShell:

```powershell
mkdir $env:USERPROFILE\projects
cd $env:USERPROFILE\projects
```

Next, create a new source file in the `projects`
folder and call it `hello-world.js`.

Open `hello-world.js` in any preferred text editor and
paste in the following content:

```js
const http = require('node:http');

const hostname = '127.0.0.1';
const port = 3000;

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello, World!\n');
});

server.listen(port, hostname, () => {
  console.log(`Server running at http://${hostname}:${port}/`);
});
```

Save the file. Then, in the terminal window, to run the `hello-world.js` file,
enter:

```bash
node hello-world.js
```

Output like this should appear in the terminal:

```console
Server running at http://127.0.0.1:3000/
```

Now, open any preferred web browser and visit `http://127.0.0.1:3000`.

If the browser displays the string `Hello, World!`, that indicates
the server is working.

[Command-line options]: cli.md#options
[Installing Node.js via package manager]: https://nodejs.org/en/download/package-manager/
[web server]: http.md

Name	Size	Permission
assets	---	0755
addons.html	108836 bytes	0644
addons.json.gz	11221 bytes	0644
addons.md	40736 bytes	0644
all.html	8015546 bytes	0644
all.json.gz	954123 bytes	0644
assert.html	196685 bytes	0644
assert.json.gz	13408 bytes	0644
assert.md	68478 bytes	0644
async_context.html	86721 bytes	0644
async_context.json.gz	7322 bytes	0644
async_context.md	25624 bytes	0644
async_hooks.html	89945 bytes	0644
async_hooks.json.gz	10057 bytes	0644
async_hooks.md	31246 bytes	0644
buffer.html	491101 bytes	0644
buffer.json.gz	29637 bytes	0644
buffer.md	152774 bytes	0644
child_process.html	173776 bytes	0644
child_process.json.gz	21374 bytes	0644
child_process.md	72154 bytes	0644
cli.html	195289 bytes	0644
cli.json.gz	30242 bytes	0644
cli.md	85212 bytes	0644
cluster.html	93340 bytes	0644
cluster.json.gz	9706 bytes	0644
cluster.md	29536 bytes	0644
console.html	61444 bytes	0644
console.json.gz	6210 bytes	0644
console.md	16891 bytes	0644
corepack.html	24606 bytes	0644
corepack.json.gz	2873 bytes	0644
corepack.md	5981 bytes	0644
crypto.html	541210 bytes	0644
crypto.json.gz	47629 bytes	0644
crypto.md	201178 bytes	0644
debugger.html	29416 bytes	0644
debugger.json.gz	3195 bytes	0644
debugger.md	7190 bytes	0644
deprecations.html	212206 bytes	0644
deprecations.json.gz	25633 bytes	0644
deprecations.md	104993 bytes	0644
dgram.html	92963 bytes	0644
dgram.json.gz	10441 bytes	0644
dgram.md	31779 bytes	0644
diagnostics_channel.html	100906 bytes	0644
diagnostics_channel.json.gz	7904 bytes	0644
diagnostics_channel.md	32310 bytes	0644
dns.html	134694 bytes	0644
dns.json.gz	16220 bytes	0644
dns.md	53667 bytes	0644
documentation.html	26969 bytes	0644
documentation.json.gz	2507 bytes	0644
documentation.md	5409 bytes	0644
domain.html	50225 bytes	0644
domain.json.gz	6352 bytes	0644
domain.md	15572 bytes	0644
embedding.html	27008 bytes	0644
embedding.json.gz	3082 bytes	0644
embedding.md	6806 bytes	0644
errors.html	299281 bytes	0644
errors.json.gz	44223 bytes	0644
errors.md	102071 bytes	0644
esm.html	93837 bytes	0644
esm.json.gz	15717 bytes	0644
esm.md	43576 bytes	0644
events.html	237833 bytes	0644
events.json.gz	17845 bytes	0644
events.md	68724 bytes	0644
fs.html	658487 bytes	0644
fs.json.gz	70238 bytes	0644
fs.md	260764 bytes	0644
globals.html	91149 bytes	0644
globals.json.gz	10906 bytes	0644
globals.md	26235 bytes	0644
http.html	312009 bytes	0644
http.json.gz	37259 bytes	0644
http.md	117904 bytes	0644
http2.html	334250 bytes	0644
http2.json.gz	41385 bytes	0644
http2.md	137100 bytes	0644
https.html	59477 bytes	0644
https.json.gz	5961 bytes	0644
https.md	17107 bytes	0644
index.html	13502 bytes	0644
index.json	54 bytes	0644
index.md	2021 bytes	0644
inspector.html	53809 bytes	0644
inspector.json.gz	4656 bytes	0644
inspector.md	13866 bytes	0644
intl.html	34436 bytes	0644
intl.json.gz	4214 bytes	0644
intl.md	11762 bytes	0644
module.html	101354 bytes	0644
module.json.gz	13061 bytes	0644
module.md	36500 bytes	0644
modules.html	83278 bytes	0644
modules.json.gz	13013 bytes	0644
modules.md	33929 bytes	0644
n-api.html	424874 bytes	0644
n-api.json.gz	54942 bytes	0644
n-api.md	232149 bytes	0644
net.html	157078 bytes	0644
net.json.gz	19767 bytes	0644
net.md	57330 bytes	0644
os.html	74233 bytes	0644
os.json.gz	9120 bytes	0644
os.md	36416 bytes	0644
packages.html	104286 bytes	0644
packages.json.gz	15970 bytes	0644
packages.md	48181 bytes	0644
path.html	55530 bytes	0644
path.json.gz	5270 bytes	0644
path.md	16058 bytes	0644
perf_hooks.html	158724 bytes	0644
perf_hooks.json.gz	13335 bytes	0644
perf_hooks.md	51463 bytes	0644
permissions.html	56995 bytes	0644
permissions.json.gz	7924 bytes	0644
permissions.md	21073 bytes	0644
policy.html	15139 bytes	0644
policy.json	476 bytes	0644
policy.md	222 bytes	0644
process.html	305702 bytes	0644
process.json.gz	33091 bytes	0644
process.md	112409 bytes	0644
punycode.html	27458 bytes	0644
punycode.json.gz	2044 bytes	0644
punycode.md	4275 bytes	0644
querystring.html	29807 bytes	0644
querystring.json.gz	2709 bytes	0644
querystring.md	5687 bytes	0644
readline.html	108164 bytes	0644
readline.json.gz	11911 bytes	0644
readline.md	39793 bytes	0644
repl.html	71031 bytes	0644
repl.json.gz	10238 bytes	0644
repl.md	24257 bytes	0644
report.html	84087 bytes	0644
report.json.gz	6546 bytes	0644
report.md	19283 bytes	0644
single-executable-applications.html	44285 bytes	0644
single-executable-applications.json.gz	5737 bytes	0644
single-executable-applications.md	14921 bytes	0644
stream.html	407042 bytes	0644
stream.json.gz	52434 bytes	0644
stream.md	149742 bytes	0644
string_decoder.html	24592 bytes	0644
string_decoder.json.gz	1586 bytes	0644
string_decoder.md	2974 bytes	0644
synopsis.html	20015 bytes	0644
synopsis.json	3031 bytes	0644
synopsis.md	2160 bytes	0644
test.html	277096 bytes	0644
test.json.gz	23417 bytes	0644
test.md	93145 bytes	0644
timers.html	59264 bytes	0644
timers.json.gz	5416 bytes	0644
timers.md	16216 bytes	0644
tls.html	185984 bytes	0644
tls.json.gz	33464 bytes	0644
tls.md	91402 bytes	0644
tracing.html	35791 bytes	0644
tracing.json.gz	3550 bytes	0644
tracing.md	8728 bytes	0644
tty.html	38416 bytes	0644
tty.json.gz	3809 bytes	0644
tty.md	9127 bytes	0644
url.html	156475 bytes	0644
url.json.gz	16251 bytes	0644
url.md	55972 bytes	0644
util.html	297783 bytes	0644
util.json.gz	27344 bytes	0644
util.md	99906 bytes	0644
v8.html	116714 bytes	0644
v8.json.gz	12388 bytes	0644
v8.md	36199 bytes	0644
vm.html	164865 bytes	0644
vm.json.gz	19687 bytes	0644
vm.md	69728 bytes	0644
wasi.html	32138 bytes	0644
wasi.json.gz	3565 bytes	0644
wasi.md	8393 bytes	0644
webcrypto.html	156306 bytes	0644
webcrypto.json.gz	10081 bytes	0644
webcrypto.md	47004 bytes	0644
webstreams.html	161173 bytes	0644
webstreams.json.gz	10686 bytes	0644
webstreams.md	39941 bytes	0644
worker_threads.html	120382 bytes	0644
worker_threads.json.gz	15281 bytes	0644
worker_threads.md	45741 bytes	0644
zlib.html	112047 bytes	0644
zlib.json.gz	10590 bytes	0644
zlib.md	35942 bytes	0644

File Content: synopsis.md

File Content: `synopsis.md`