Node.js Translation to Spanish - (1352 words) (Part-65)
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.
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, 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 Functions to convert from C types to N-API
Functions to convert from C types to N-API
napi_create_int64
This API is used to convert from the C int64_t
type to the JavaScript Number type.
The JavaScript Number type is described in Section 6.1.6 of the ECMAScript Language Specification. Note the complete range of int64_t
cannot be represented with full precision in JavaScript. Integer values outside the range of Number.MIN_SAFE_INTEGER
-(2^53 - 1) - Number.MAX_SAFE_INTEGER
(2^53 - 1) will lose precision.
napi_get_arraybuffer_info
This API is used to retrieve the underlying data buffer of an ArrayBuffer and its length.
WARNING: Use caution while using this API. The lifetime of the underlying data buffer is managed by the ArrayBuffer even after it's returned. A possible safe way to use this API is in conjunction with [napi_create_reference][]
, which can be used to guarantee control over the lifetime of the ArrayBuffer. It's also safe to use the returned data buffer within the same callback as long as there are no calls to other APIs that might trigger a GC.
Funciones para convertir de tipos de C a N-API
napi_create_int64
Esta API se utiliza para convertir desde el tipo de C int64_t
al tipo de Número de JavaScript.
El tipo de Número de JavaScript se describe en la Sección 6.1 de las Especificaciones del Lenguaje ECMAScripts. Tenga en cuenta que el rango completo de int64_t
no puede ser representado con total precisión en JavaScript. Los valores enteros fuera del rango de Number.MIN_SAFE_INTEGER
-(2^53 - 1) - Number.MAX_SAFE_INTEGER
(2^53 - 1) perderán precisión.
napi_get_arraybuffer_info
Esta API se utiliza para recuperar el buffer de datos subyacente de un ArrayBuffer y su longitud.
ADVERTENCIA: Tenga cuidado al utilizar esta API. El ArrayBuffer administra la vida útil del buffer de datos subyacente incluso después de su devolución. Una manera segura y posible de utilizar esta API es hacerlo en conjunto con [napi_create_reference][]
, la cual puede ser utilizada para garantizar el control sobre la vida útil del ArrayBuffer. También es seguro utilizar el buffer de datos devuelto dentro de la misma callback de terminación, siempre que no existan llamadas a otras APIs que puedan desencadenar un GC.
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 1352 words.
- I've translated a total of 86474 words so far*
*Considering non-translatable content (proper names, functions, codes, etc.)
Previous translations on this project
Part 61
- Maintaining-V8.md (v6.x)
Part 56
Part 53
Part 52
Part 13
- Maintaining-V8.md (v10.x)
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.
Greetings @cremisi,
Thank you for submitting your contribution!
This is a very interesting project that contains many code values and terms related to computer science. Its difficulty relies on the fact that we must pay a lot of attention to the code in order to deliver the most accurate translation possible.
The overall presentation of your post is great, it is well written and formatted, includes all the basic details, useful examples and concepts.
You delivered an accurate translation. You used the correct vocabulary and you were careful with code values that should not be translated in order to make sure the text keeps its true meaning.
I'm looking forward to your next contribution!
Your contribution has been evaluated according to Utopian policies and guidelines, as well as a predefined set of questions pertaining to the category.
To view those questions and the relevant answers related to your post, click here.
Chat with us on Discord
Thank you for your review, @marugy99! Keep up the good work!
Congratulations @cremisi! You have completed the following achievement on the Steem blockchain and have been rewarded with new badge(s) :
You can view your badges on your Steem Board and compare to others on the Steem Ranking
If you no longer want to receive notifications, reply to this comment with the word
STOP
Vote for @Steemitboard as a witness to get one more award and increased upvotes!
Hi @cremisi!
Your post was upvoted by @steem-ua, new Steem dApp, using UserAuthority for algorithmic post curation!
Your post is eligible for our upvote, thanks to our collaboration with @utopian-io!
Feel free to join our @steem-ua Discord server
Hey, @cremisi!
Thanks for contributing on Utopian.
We’re already looking forward to your next contribution!
Get higher incentives and support Utopian.io!
Simply set @utopian.pay as a 5% (or higher) payout beneficiary on your contribution post (via SteemPlus or Steeditor).
Want to chat? Join us on Discord https://discord.gg/h52nFrV.
Vote for Utopian Witness!