Repository

https://github.com/nodejs/i18n

Project Details

Node.js is an open-source, cross-platform JavaScript run-time environment that executes JavaScript code outside of a browser.

Node.js came into existence when the original developers of JavaScript extended it from something you could only run in the browser to something you could run on your machine as a standalone application.

In simple words, it's an open source execution environment for developing web applications, which is event-based, it uses the V8 engine to provide an execution environment that compiles and executes JavaScript at a higher speed. It is possible to run Node.js without any restriction on Windows, Linux and Mac OS X.

It should be noted that it is NOT a server language, this means that it executes code, so it could be understood as an interpreter.

Contribution Specifications

Node.js is currently being translated into 33 languages. I'm contributing to translate it into the Spanish language.

So far, we have managed to translate 68% of the project!

Translation Overview

I started the translation of the folder N-api.md.

N-API (pronounced N as in the letter, followed by API) is an API for building native Addons. It is independent from the underlying JavaScript runtime (ex V8) and is maintained as part of Node.js itself.

Previously, I briefly explained what an API is. If you want to see more information about it, you can visit this post.

The N-API is an API that ensures ABI stability across Node.js versions and different compiler levels. And an ABI (application binary interface) it's the interface between two program modules, it determines details such as how to call functions, in which binary format information should be passed from one program component to the next, or to the operating system in the case of a system call.

In this part of the module the envelope of objects and their functions is explained.

N-API offers a way to "wrap" C++ classes and instances so that the class constructor and methods can be called from JavaScript.

• The [napi_define_class][] API defines a JavaScript class with constructor, static properties and methods, and instance properties and methods that correspond to the C++ class.
• When JavaScript code invokes the constructor, the constructor callback uses [napi_wrap][] to wrap a new C++ instance in a JavaScript object, then returns the wrapper object.
• When JavaScript code invokes a method or property accessor on the class, the corresponding napi_callback C++ function is invoked. For an instance callback, [napi_unwrap][] obtains the C++ instance that is the target of the call.

For wrapped objects it may be difficult to distinguish between a function called on a class prototype and a function called on an instance of a class. A common pattern used to address this problem is to save a persistent reference to the class constructor for later instanceof checks.

As an example of the work done, I will use the function napi_wrap belonging to this module:

---

---

Note: This API may modify the prototype chain of the wrapper object. Afterward, additional manipulation of the wrapper's prototype chain may cause napi_unwrap() to fail.

Languages

This contribution was translated from English to Spanish.

Word Count

The number of words reflected in the title doesn't include words that didn't require a translation.

• In this contribution, I've translated 1122 words.
• I've translated a total of 91004 words so far*

*Considering non-translatable content (proper names, functions, codes, etc.)

Previous translations on this project

• N-api.md.

From Part 62 to Part 67

• Timers-in-node.md

Part 61

• Maintaining-V8.md (v6.x)

Parts 59 and 60

• Net.md

Parts 57 and 58

• Onboarding.md

Part 56

• Event-loop-timers-and-nexttick.md

Parts 54 and 55

• VM.md

Part 53

• Building-node-with-Ninja.md

Part 52

• ChangeLog_V7.md

From Part 41 to Part 51

• ChangeLog_V8.md

From Part 14 to Part 40

• Using-Internal-Errors.md and Building-Node-with-Ninja.md

Part 13

• Maintaining-V8.md (v10.x)

Parts 11 and 12.

• Pull-requests-md

From Part 7 to Part 10

• TLS.md

From Part 1 to Part 6

Proof of Authorship

This counter includes non-translatable words, so it is necessary to work on more content to extract an average of 1000 translatable words.

You can check My Crowdin Profile for verify my contribution in this project.