![](https://cdn.steemitimages.com/DQmbrioY3P2uEDwSfLZciQeL2GUMxPiujLjB3uWQbc4DNv4/image.png)

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

<center>![Captura de pantalla 20190507 a las 11.11.36.png](https://files.steempeak.com/file/steempeak/cremisi/KTxIjfAr-Captura20de20pantalla202019-05-0720a20las2011.11.36.png)</center>

<center>So far, we have managed to translate **61%** of the project!</center>

## Translation Overview

I started the translation of the folder [N-api.md](https://crowdin.com/translate/nodejs/49/en-es).

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](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1498-words-part-53).

The N-API is an API that ensures ABI stability across Node.js versions and different compiler levels. Here comes this term that I did not know until now: an ABI (application binary interface) it's the interface between two program modules. An ABI 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.

N-API uses both return values and JavaScript exceptions for error handling. As an example of the work done, I will use the section *return values*.


<div class="text-justify">
<div class="pull-left">

<center>**English:**</center>

### Return values

All of the N-API functions share the same error handling pattern. The return type of all API functions is `napi_status`.

The return value will be `napi_ok` if the request was successful and no uncaught JavaScript exception was thrown. If an error occurred AND an exception was thrown, the `napi_status` value for the error will be returned. If an exception was thrown, and no error occurred, `napi_pending_exception` will be returned.

In cases where a return value other than `napi_ok` or `napi_pending_exception` is returned, `[napi_is_exception_pending][]` must be called to check if an exception is pending. See the section on exceptions for more details.

The full set of possible `napi_status` values is defined in `napi_api_types.h.`

The `napi_status` return value provides a VM-independent representation of the error which occurred. In some cases it is useful to be able to get more detailed information, including a string representing the error as well as VM (engine)-specific information.

In order to retrieve this information `[napi_get_last_error_info][]` is provided which returns a `napi_extended_error_info structure. `

</div> </div>

<div class="pull-right">

<center>**Spanish:**</center>

### Valores de retorno

Todas las funciones N-API comparten el mismo patrón de manejo de errores. El tipo de retorno de todas las funciones API es `napi_status`.

El valor de retorno será `napi_ok` si la petición fue exitosa y no se arrojó ninguna excepción de JavaScript no capturada. Si ha ocurrido un error y una excepción fue arrojada, el valor de `napi_status` para el error será devuelto. Si una excepción fue arrojada y no ocurrió ningún error, `napi_pending_exception` será devuelto.

En casos donde se devuelva un valor de retorno distinto a `napi_ok` o `napi_pending_exception`, `[napi_is_exception_pending][]` debe ser llamado para verificar si hay una excepción pendiente. Consulte la sección de excepciones para más detalles.

El conjunto completo de los valores `napi_status` posibles está definido en `napi_api_types.h.`

El valor de retorno `napi_status` proporciona una representación del error ocurrido independiente de VM. En algunos casos, es útil poder obtener información más detallada, incluyendo una string que represente el error, así como información específica (del motor) de VM.

Para recuperar esta información, se proporciona `[napi_get_last_error_info][]`, el cual devuelve una estructura `napi_extended_error_info`. 

</div></div>

_____

## 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 **1166** words.
- I've translated a total of **82145** words so far*

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

## Previous translations on this project

- [Timers-in-node.md](https://crowdin.com/translate/nodejs/80/en-es#26667)

Part [61](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1126-words-part-61)

- [Maintaining-V8.md](https://crowdin.com/translate/nodejs/78/en-es) (v6.x)

Parts [59](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1065-words-part-59) and [60](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1299-words-part-60)

- [Net.md](https://crowdin.com/translate/nodejs/50/en-es)

Parts [57](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1288-words-part-57) and [58](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1303-words-part-58)

- [Onboarding.md](https://crowdin.com/translate/nodejs/83/en-es)

Part [56](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1481-words-part-56)

- [Event-loop-timers-and-nexttick.md](https://crowdin.com/translate/nodejs/87/en-es)

Parts [54](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1040-words-part-54) and [55](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1135-words-part-55)

- [VM.md](https://crowdin.com/translate/nodejs/138/en-es)

Part [53](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1498-words-part-53)

- [Building-node-with-Ninja.md](https://crowdin.com/translate/nodejs/77/en-es)

Part [52](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1101-words-part-52)

- [ChangeLog_V7.md](https://crowdin.com/translate/nodejs/222/en-es)

From [ Part 41](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1200-words-part-41) to [Part 51](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1008-words-part-51)

- [ChangeLog_V8.md](https://crowdin.com/translate/nodejs/223/en-es)

From [Part 14](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1221-words-part-14) to [Part 40](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1479-words-part-40)

- [Using-Internal-Errors.md](https://crowdin.com/translate/nodejs/234/en-es) and [Building-Node-with-Ninja.md](https://crowdin.com/translate/nodejs/226/en-es)

Part [13](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1015-words-part-13)

- [Maintaining-V8.md](https://crowdin.com/translate/nodejs/230/en-es) (v10.x)

Parts [11](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1184-words-part-11) and [12](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1212-words-part-12).

- [Pull-requests-md](https://crowdin.com/translate/nodejs/229/en-es)

From [Part 7](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1046-words-part-7) to [Part 10](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1022-words-part-10)

- [TLS.md](https://crowdin.com/translate/nodejs/206/en-es)

From [Part 1](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1005-words-part-1) to [Part 6](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1035-words-part-6)

## Proof of Authorship

![Captura de pantalla 20190507 a las 11.15.37.png](https://files.steempeak.com/file/steempeak/cremisi/ranjVJth-Captura20de20pantalla202019-05-0720a20las2011.15.37.png)

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](https://crowdin.com/profile/cremisi) for verify my contribution in this project.