![](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 20190513 a las 22.49.38.png](https://files.steempeak.com/file/steempeak/cremisi/p8WUknqV-Captura20de20pantalla202019-05-1320a20las2022.49.38.png)</center>

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

## Translation Overview

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

<center>![1_qwoA9FmZDrE5q_9qqBCQ.png](https://files.steempeak.com/file/steempeak/cremisi/we9mQtxr-1_qwoA9FmZDrE5q--_9qqBCQ.png)</center>

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. 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, how to work with JavaScript properties is explained.

N-API exposes a set of APIs to create all types of JavaScript values. Fundamentally, these APIs are used to do one of the following:

- Create a new JavaScript object
- Convert from a primitive C type to an N-API value
- Convert from N-API value to a primitive C type
- Get global instances including undefined and null

As an example of the work done, I will use part of this section called *Object Creation Functions*
___

<div class="pull-left">

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

### Object Creation Functions

<div class="text-justify">

`napi_create_array_with_length`

This API returns an N-API value corresponding to a JavaScript Array type. The Array's length property is set to the passed-in length parameter. However, the underlying buffer is not guaranteed to be pre-allocated by the VM when the array is created - that behavior is left to the underlying VM implementation. If the buffer must be a contiguous block of memory that can be directly read and/or written via C, consider using `[napi_create_external_arraybuffer][]`.

</div> </div>

<div class="pull-right">

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

### Funciones de creación de objetos

<div class="text-justify">

`napi_create_array_with_length`

Esta API devuelve un valor de N-API que corresponde a un tipo de Array de JavaScript. La propiedad de longitud del Array se establece en el parámetro de longitud pasado. Sin embargo, la VM no garantiza que el buffer subyacente sea preasignado cuando se cree el array - ese comportamiento se deja a la implementación de la VM subyacente. Si el buffer debe ser un bloque contiguo de memoria que pueda ser leído y/o escrito directamente desde C, considere utilizar `[napi_create_external_arraybuffer][]`.

</div></div>

_____
JavaScript arrays are described in [Section 22.1](https://tc39.github.io/ecma262/#sec-array-objects) of the ECMAScript Language Specification.

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

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

## Previous translations on this project

- [N-api.md](https://crowdin.com/translate/nodejs/49/en-es).

Parts [62](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1166-words-part-62) and [63](https://steemit.com/utopian-io/@cremisi/node-js-translation-to-spanish-1137-words-part-63)

- [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 20190513 a las 22.48.43.png](https://files.steempeak.com/file/steempeak/cremisi/ri3yIDaS-Captura20de20pantalla202019-05-1320a20las2022.48.43.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.