Ahead, there is the link of the program's webpage:
This is my 43rd contribution to Node.js as a translator. For this collaboration, I continued my previous work on Node.js’ version 6 url.md file, which describes the features, characteristics and uses of
url module of Node.
In my previous contribution, i talked about APIs and WHATWG, since they're introduced in the document from the begining:
The url module provides two APIs for working with URLs: a legacy API that is Node.js specific, and a newer API that implements the same WHATWG URL Standard used by web browsers.
In this contribution, I'll explain a important concepts referred in the WHATWG URL API of the
The first one I'll talk about is hash. It is included as a property of the
URL class, as
url.hash. What does hash mean? Hashing is a data processing mechanism through which a long string of data is transformed into a way shorter string that represents the original one. Reducing a single string might not seem like a big deal, but it comes quite handy at the time we start dealing with enormous amounts of digital information or just wanna have a quicker, more organized, look of the data we have to work with.
If we simplify this concept to a maximum extent... It is like a programming shrink ray!:
Secondly, I would like to discuss what is percent-encoding since many strings of this document refer to this concept at the time of dealing with invalid characters in properties:
- Invalid URL characters included in the value assigned to the
hashproperty are percent-encoded.
- Invalid URL characters included in the value assigned to the
passwordproperty are percent-encoded.
- Any invalid URL characters appearing in the value assigned the
searchproperty will be percent-encoded.
Percent-encoding is a programming mechanism to encode 8-bit characters into URL-readable data. This way, certain characteres that do not exist within the range of URL universe manage to pass in it and later be translated by web browsers and pages. The mechanism for this codification is to substitute the unavaible character by a
% symbol and, next to it, the hexadecimal representation of the ASCII value of said character.
The characters that need percent encoding are
% (oh, the irony).
The respective codification for each is the following (thanks, Mozilla, for making such dinamic and useful manuals... Big time!):
Finally, I would like to talk about serialization. In this file, there are a lot of references to URL and domain serialization, as:
toJSON()method on the
URLobject returns the serialized URL.
- Returns the search parameters serialized as a string, with characters percent-encoded where necessary.
- Returns the Punycode ASCII serialization of the
- Returns the Unicode serialization of the
In computer science, the process of serialization refers to the mechanism through which a piece of data or an object is transformed into a format that can be buffered or saved in the physical memory of a system as a file. In the case of Java, the objects are turned into byte streams, which can later be changed again into copies of the original objects. It's not magic...
It's just programming.
You can find out more about the aforementioned concepts here:
Thanks for taking your time to read! Expect more information and tips on the next report :)
Work example #01:
Setting the value to the default port of the
URL objects given
protocol will result in the
port value becoming the empty string
Establecer el valor del puerto predeterminado del
protocol dado de los objetos
URL ocasionará que el valor del
port se convierta en la string vacía
Work example #02:
Note that the selection of which characters to percent-encode may vary somewhat from what the [
url.parse()] and [
url.format()] methods would produce.
Tenga en cuenta que la selección de los caracteres a ser codificados porcentualmente puede ser distinta de la que los métodos [
url.parse()] y [
Work example #03:
iterable can be another
URLSearchParams, in which case the constructor will simply create a clone of the provided
Eso significa que
iterable puede ser otro
URLSearchParams, en cuyo caso el constructor simplemente creará un clon del
This translation was made from English to Spanish.
I got plenty experience translating and proofreading this project as an Utopian contributor. I collaborate here as translator and Language Moderator of the Da-Vinci/Utopian Spanish translation team. Besides this project, I have experience translating and proofreading The Curious Expedition, Ancap-ch, Byteball Wiki, OroCrm and BiglyBT.
- The amount of words translated in this contribution is: 1,218.
Note: This number is the result of subtracting the complete sum of non-translatable content to the word-count Crowdin has done for the period in which this contribution was done.
- The total amount of words translated in this project (as a Da-vinci/Utopian translator) is: 53,451.
Previous Translations of the Project
- Contribution N'01. Submitted on September 13th, 2018.
- Contribution N'02. Submitted on September 15th, 2018.
- Contribution N'03. Submitted on September 17th, 2018.
- Contribution N'04. Submitted on September 19th, 2018.
- Contribution N'05. Submitted on September 21th, 2018.
- Contribution N'06. Submitted on September 22th, 2018.
- Contribution N'07. Submitted on September 23th, 2018.
- Contribution N'08. Submitted on October 1st, 2018.
- Contribution N'09. Submitted on October 8th, 2018.
- Contribution N'10. Submitted on October 14th, 2018.
- Contribution N'11. Submitted on October 15th, 2018.
- Contribution N'12. Submitted on October 18th, 2018.
- Contribution N'13. Submitted on October 21st, 2018.
- Contribution N'14. Submitted on October 24th, 2018.
- Contribution N'15. Submitted on October 27th, 2018.
- Contribution N'16. Submitted on October 31th, 2018.
- Contribution N'17. Submitted on November 3rd, 2018.
- Contribution N'18. Submitted on November 4th, 2018.
- Contribution N'19. Submitted on November 6th, 2018.
- Contribution N'20. Submitted on November 17th, 2018.
- Contribution N'21. Submitted on November 24th, 2018.
- Contribution N'22. Submitted on December 7th, 2018.
- Contribution N'23. Submitted on December 15th, 2018.
- Contribution N'24. Submitted on December 20th, 2018.
- Contribution N'25. Submitted on December 26th, 2018.
- Contribution N'26. Submitted on December 28th, 2018.
- Contribution N'27. Submitted on December 30th, 2018.
- Contribution N'28. Submitted on January 9th, 2019.
- Contribution N'29. Submitted on January 10th, 2019.
- Contribution N'30. Submitted on January 12th, 2019.
- Contribution N'31. Submitted on January 18th, 2019.
- Contribution N'32. Submitted on January 19th, 2019.
- Contribution N'33. Submitted on January 24th, 2019.
- Contribution N'34. Submitted on January 28th, 2019.
- Contribution N’35. Submitted on January 31st, 2019.
- Contribution N’36. Submitted on March 3rd, 2019.
- Contribution N’37. Submitted on March 6th, 2019.
- Contribution N’38. Submitted on April 3rd, 2019.
- Contribution N’39. Submitted on April 16th, 2019.
- Contribution N’40. Submitted on April 19th, 2019.
- Contribution N’41. Submitted on May 28th, 2019.
- Contribution N’42. Submitted on July 8th, 2019.
Proof of Authorship
This translation was made on July 9th, 2019. You can check the translation record in my Crowdin account [here], the activity on the project's Crowdin [here] and a summary of recent additions to the project [here].