Time flies when you are having fun! It has been over seven years since Node.js v0.10.x was released and now we are welcoming the seventh major release since the formation of the Node.js Foundation: Node.js v10.0.0! Our peppy non-blocking I/O friend has changed so much since then. Let's review what new, what has changed and what has been deprecated in this new release!

Support for Modern Cryptography

Node.js 10 gets an upgrade to OpenSSL v1.1.0. In addition, cryptographic support now includes the ChaCha20 cipher and the Poly1305 authenticator. According to IETF documentation, ChaCha20 is a high-speed cipher (much faster than AES in software only-implementations) that is not sensitive to timing attacks. The same organization defines Poly1305 as a high-speed message authentication code with a straight-forward and easy implementation. In 2014, Google deployed a new cipher suite in Chrome that runs three times faster than AES-GCM on most Android devices leading to an improvement in battery life and encryption performance. This TLS cipher suite implements ChaCha 20 for symmetric encryption and Poly1305 for authentication.

The future release of OpenSSL 1.1.1 includes support for TLS 1.3 which now includes the ChaCha20 stream cipher with the Poly1305 message authentication code to make the web much more secure. With the addition of OpenSSL 1.1.0, Chacha20 and Poly1305 makes it easy to bring TLS 1.3 support to Node.js before it reaches Long Term Support (LTS) in October 2018 bringing cutting-edge cryptography to the ecosystem.

Experimental Promisified fs Functions

The experimental fs/promises API gives us a set of alternative asynchronous file system methods that return a Promise object instead of using callbacks. We can access this API through require('fs/promises').

Let's explore an example of the fs Promises API. To do so, we need to have Node v10.0.0 installed. I recommend that you install the current version through a Node Version Manager such as nvm so that you can switch between versions as you need to.

With Node v10.0.0 installed and selected, create a NodeJS project anywhere you'd like by using npm init.

On the project directory, create the following files:

  • temp.txt: a file that we are going to read.
  • app.js: the Node application that we are going to use for demonstration. The application reads a file and truncates its content to the first 4 characters.

Open temp.txt and type "Node.js" inside and save it.

Then, open app.js and include the following headings:

// app.js

const fs = require('fs');
const fsPromises = require('fs/promises');

fs is the usual module we are used to working with. fs/promises brings the new API into our application.

Next, let's read temp.txt and print its current content in the console:

const fs = require('fs');
const fsPromises = require('fs/promises');

console.log(fs.readFileSync('temp.txt', 'utf8'));
// Prints: Node.js

Now, we are going to create a function called doTruncate that asynchronously opens the file using open() and truncates the content of the file using ftruncate, both methods of the fs/promises library. We are going to manage the promises through the async/await pattern and print the resulting truncation to the console:

const fs = require('fs');
const fsPromises = require('fs/promises');

console.log(fs.readFileSync('temp.txt', 'utf8'));
// Prints: Node.js

async function doTruncate() {
    const fd = await fsPromises.open('temp.txt', 'r+');
    await fsPromises.ftruncate(fd, 4);
    console.log(fs.readFileSync('temp.txt', 'utf8'));  
    // Prints: Node


The absence of callbacks makes the code clean, elegant and readable. In just three lines of code, we are able to execute all the logic of doTruncate as if it was synchronous. If any error is thrown, we catch it by chaining a catch to doTruncate. No need to use a try/catch block within the function.

New JavaScript Language Features

These are the highlights of the features included in the V8 v6.6 release that ships with Node v10.0.0:

  • Function.prototype.toString()

This method now returns exact slices of source text which include whitespace and comments.

function /* This is a comment */ f   () {
    const num = 10;


The console output now includes the comment between function and f as well as the whitespace after f:

function /* This is a comment */ f   () {
    const num = 10;

In previous versions of Node.js, the output would have been:

function f() {
    const num = 10;
  • The catch clause of try statements no longer requires a parameter. Here's an example from the release notes:
try {
} catch {
  • Non-standard methods trimLeft() and trimRight() becomes aliases for the newly implemented String.prototype.trimStart() and String.prototype.trimEnd() to ensure backward compatibility:
const string = '  Node rocks!  ';



Node rocks!  
  Node rocks!
Node rocks!

Read more details on the changes in the JavaScript languages features in the V8 project blog.

Performance Improvements

  • Promises and async functions get a performance boost. The V8 Engineering team has been able to close the gap between async functions and raw promise chains.

Promise performance improvements

Source: V8 Project Blog

  • The performance of async generators along with async iterations was largely improved.

Async generators performance improvements

Source: V8 Project Blog

  • For holey double arrays, the throughput performance of Array#reduce increased by more than 10x.

Array#reduce performance improvements

Source: V8 Project Blog

Read more details on the performance improvements present in V8 v6.6 in the V8 project blog.

Better Error Handling

As Michael Dawson explains, until recently, Node.js only had messages associated with Errors thrown. This made error management challenging and, ironically, error-prone since you needed to compare the error message string to a known value to determine what kind of error was thrown and what action your code should take. This has made it difficult to maintain error management in the codebase since any changes in the error messages thrown by the API would break the code. What this meant for the Node.js team is that any error message changes, including something small such as a typo, would need to be queued for a major release.

To solve this problem and enable the team to have the flexibility to improve error messages within minor releases, the Node.js team has been making an effort to add an error code for every error object thrown by the Node.js API. This effort continues with the latest release. Complete implementation of this initiative would not only make error management easier for developers but also error messages can be backported to previous versions and internationalization of applications is made much easier.

NPM v6 On the Horizon

Down the road, Node.js v10 will see its integration with NPM v6 early in its life. NPM6 prioritizes security, performance enhancements, and workflow optimization. The NPM team claims that npm@6 will be able to deliver up to 17x the speed of npm a year ago. Sounds promising!

"Node v10 will integrate with NPM v6 before it goes into LTS status in October 2018. Get ready to witness up to 17x the speed of last year's npm!"

Node.js Time Travel

This version also comes with the experimental release of Node-ChakraCore that facilitates the usage of the Time-Travel innovation through the usage of the NodeChakra Time Travel Debug VSCode extension. The extension allows developers to manage time traveling easily from the editor.

Full Support of N-API

The N-API native Addons API graduates from its experimental status. But, what's N-API anyways?

N-API is an API that allows developers to build native Addons. Node.js Addons are used to provide a performance boost to our codebase when JavaScript performance isn't enough. Node.js Addons provide us with an interface between JavaScript running in Node.js and C/C++ libraries. We can use that interface to build dynamically-linked shared objects in C++ that we can load into a Node.js application through a require() function.

Node.js Addons behave the same as regular Node.js modules but offer a performance boost for computationally demanding applications. By using Addons, we can also interact with lower level APIs of the operating system. All this sounds great; however, the implementation of Addons has been rather complicated, demanding knowledge of different components of Node.js including V8, libuv, C++ APIs, and other statically linked libraries such as OpenSSL.

N-API comes in place to simplify this process by offering an API to build native Addons that is independent of the underlying JavaScript runtime (V8). The goal is to insulate Addons to be stable across versions of Node.js: modules compiled for one version can run on later versions without recompilation. This is all done by making N-API Application Binary Interface (ABI) stable. We've heard API before, what's an ABI?

If an API is a contract between code modules, an ABI is a contract between pieces of binary code as explained by Google Engineer Robert Love: an Application Binary Interface (ABI) "defines the mechanisms by which functions are invoked, how parameters are passed between caller and callee, how return values are provided to callers, how libraries are implemented, and how programs are loaded into memory." A stable ABI for Addons will make upgrading codebases that rely on native modules much easier.

"Native code dependencies that are critical to the business are a core reason why some teams delay upgrading Node. The new N-API makes the migration easy with this release and effortless with future releases!"

Node Addons are a very advanced concept of the ecosystem. However, if you are looking to create some ultra-performance native modules do not hesitate to take a look and study the C++ Addons documentation.


The following are highlights of the API's that have been deprecated in this release:

  • Using non-string values for process.env has been deprecated in documentation.
  • Previously deprecated legacy async_hooks APIs have reached end-of-life and have been removed.
  • Previously deprecated internal getters/setters on net.Server have reached end-of-life and have been removed.
  • Using require() to access several of Node.js' own internal dependencies will emit a runtime deprecation.

For a full list of the deprecated APIs in this release, please visit the v10.0.0 release notes.


Node.js continues to grow and evolve into a solid, flexible and diverse platform for developers to deliver reliable and scalable code. I am pretty excited about the future integration with TLS 1.3 and @npm6. Node.js will also continue to gain traction in the IoT area. What do you think about this release? If you have used it already, have you been able to experience any of the performance enhancements? Please let me know in the comments below!

Happy coding!

About Auth0

Auth0, a global leader in Identity-as-a-Service (IDaaS), provides thousands of enterprise customers with a Universal Identity Platform for their web, mobile, IoT, and internal applications. Its extensible platform seamlessly authenticates and secures more than 1.5B logins per month, making it loved by developers and trusted by global enterprises. The company's U.S. headquarters in Bellevue, WA, and additional offices in Buenos Aires, London, Tokyo, and Sydney, support its customers that are located in 70+ countries.

For more information, visit https://auth0.com or follow @auth0 on Twitter.