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 69% of the project!

Translation Overview

For this contribution, I have finished translating the N-api.md folder.

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 final part of the module, simple asynchronous operations are explained.

Additional modules often need to take advantage of the libuv asynchronous helpers as part of their implementation. This allows them to schedule the job to run asynchronously so that their methods can return before the job is completed. This is important to allow them to avoid blocking the general execution of the Node.js application.

It also explains the use of custom asynchronous operations, considering that the simple asynchronous work APIs may not be appropriate for each scenario, and these APIs are necessary to ensure that the execution time correctly tracks an asynchronous operation.

Via Lemoncode

Recall that when an operation is asynchronous, the completion of the operation is notified to the main program and the processing of the response will be made at some future time.

I will use as an example the simple asynchronous operation function napi_cancel_async_work:

---

I will also use the custom asynchronous operation function napi_cancel_async_work:

---

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 1521 words.
• I've translated a total of 92815 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 68

• 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.