Links

Github

Crowdin

Official website

Project Details

Node.js is not a programming language but could be considered as a Java Script programming framework, although in reality the definition of framework is not entirely appropriate, as Node.js could be confused with an environment to create a particular type of applications. To be precise, Node.js is a framework / platform for running JavaScript applications
We therefore say that the most appropriate definition would be that of "platform for the execution of JavaScript applications", as we find written on the home page of the official website; in practice it is a JavaScript run-time, therefore a motor for the execution of JavaScript code.

Introduction

I'm glad that on Node.js I have the chance to start a file from scratch and working to complete its translation: in my previous project instead, there were many files partially translated by other users that just had some scatter word or sentence to render and this sometimes need more time and makes your work unpleasant and confused.
As I have already explained, the whole Italian team is working on Node.js and we are processing all the first folder (API) files, following the descending order as much as possible, to give a better translation.

Contribution Specifications

This report is about my 13th contribution to Node.js translation in Italian.
I processed more than 1400 words to get +1200 clean words, reaching the 55% of util.md folder already rendered.
In a couple of sentences I preferred changing punctuation: I replaced a comma from the source string with a semicolon in my Italian translation. See the third example below.

Moreover I found somewhere on the web use cases of doSomething function: it seems that when this function is described using these same terms, we adopt in Italian this form: " Eseguire le istruzioni". See the second example.

I should check my previous contributions to modify them if confirmed by my LM.

Translation Overview

1.util.inspect(object[, options])

Using the showHidden option allows to inspect [WeakMap][] and [WeakSet][] entries. If there are more entries than maxArrayLength, there is no guarantee which entries are displayed. That means retrieving the same [WeakSet][] entries twice might actually result in a different output. Besides this any item might be collected at any point of time by the garbage collector if there is no strong reference left to that object. Therefore there is no guarantee to get a reliable output.

2.util.promisify(original)

Takes a function following the common error-first callback style, i.e. taking an (err, value) => ... callback as the last argument, and returns a version that returns promises.
const util = require('util');
const fs = require('fs');

const stat = util.promisify(fs.stat);
stat('.').then((stats) => {
// Do something with stats
}).catch((error) => {
// Handle the error.
});

3.util.promisify.custom

If there is an original[util.promisify.custom] property present, promisify will return its value, see Custom promisified functions.

promisify() assumes that original is a function taking a callback as its final argument in all cases. If original is not a function, promisify() will throw an error. If original is a function but its last argument is not an error-first callback, it will still be passed an error-first callback as its last argument.

Languages

SOURCE LANGUAGE: English

TARGET LANGUAGE: Italian

To check my previous experiences as a translator you can consult my activities on Verdaccio and Joomla projects, selecting my name in the drop-down menu.
You can also view my application for Davinci.

Word count

Words Translated: +1200

Proof of Authorship

You can look up Crowdin project on the following link, as well as the summary of my activities.

Credits

I'd like to thank @davinci.witness and @utopian-io for this wonderful project I have the pleasure to work in and another big thank to the italian team, especially to the LM @imcesca and our Node.js expert @robertbira.

VOTE FOR DAVINCI.WITNESS & FOLLOW DAVINCI WITNESS TRAIL

(Image by @pab.ink)

The first image is public domain - Source Wikicommon