NodeJS

From David's Wiki
Jump to navigation Jump to search

Node.js is a JavaScript environment based on Chrome's V8 JavaScript engine. Node Package Manager (npm) is used to manage node packages installed on your computer or used in your node projects.

Installation

Windows

Just download the latest LTS release from the Node.js website

Linux

Using the Node Version Manager (nvm) is recommended. This does not require sudo as nvm is installed in your home directory. You should never use sudo when using npm. Doing so could lead to permission issues.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# Reload .bashrc
source ~/.bashrc
nvm install --lts node
nvm install-latest-npm

Usage

JavaScript files can be run directly using node index.js

Filesystem Access

Install fs-extra to your project.

const fs = require('fs-extra');
const path = require('path');

// Synchronous functions

//// Only in fs-extra
// Remove file or folder (rm -rf)
// Does nothing if path doesn't exist
fs.removeSync('/tmp/fileOrFolder');

// Creates a directory if it doesn't exist
// This example will create folder1 and folder2 if they don't exist
fs.ensureDirSync('/tmp/folder1/folder2');

//// Available in node's native 'fs'
// List all files and folders in a directory
fs.readdirSync('/tmp');

// Ensure file exists
try {
  fs.accessSync('etc/passwd', fs.constants.R_OK | fs.constants.W_OK);
  console.log('can read/write');
} catch (err) {
  console.error('no access!');
}

// Read an entire text file as a string
fs.readFileSync('temp.txt', 'utf8');

Logging

Mostly the same as web JavaScript.
Reference

console.log("a", "b");

console.error("to stderr");

CSV

Install csv from npm.
Reference


Running other processes

You can invoke other processes or CLI programs using spawn or spawnSync

const {spawn} = require('child_process');

Package Management

NPM

To add node packages to an new project. Use npm init
To download the dependencies for a node project, run npm install or npm ci.
npm install installs the latest dependencies listed in package.json subject to the requirements listed in that file. It also updates package-lock.json.
npm ci installs exact versions from the package-lock.json.

Yarn

Yarn is an alternative to npm. It caches packages on disk to speed up installs. While you can migrate from npm to yarn, it is recommended to stick to a single package manager since they each use their own lockfile.

pnpm

pnpm uses symlinks to a single copy of each dependency to save disk space. pnpm uses its own lockfile instead of packages-lock.json.

Useful Packages

fs-extra

fs-extra adds additional commands for accessing the filesystem such as copying and moving files.