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

alt

Repository

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.