Node.js Translation to Spanish - (1166 words) (Part-62)

in #utopian-io6 years ago (edited)

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.

Captura de pantalla 20190507 a las 11.11.36.png

So far, we have managed to translate 61% 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. 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.

English:

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.

Spanish:

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.


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

Part 61

Parts 59 and 60

Parts 57 and 58

Part 56

Parts 54 and 55

Part 53

Part 52

From Part 41 to Part 51

From Part 14 to Part 40

Part 13

Parts 11 and 12.

From Part 7 to Part 10

From Part 1 to Part 6

Proof of Authorship

Captura de pantalla 20190507 a las 11.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 for verify my contribution in this project.

Sort:  

Greetings @cremisi,

Thank you for submitting your contribution!

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

  • Your presentation post includes all the basic information related to the project, interesting concepts and useful examples of your work as a translator.

  • Regarding your translation, you did a very good job. 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.

Keep up the good work :D

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!

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!

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