From fa1a872ec1aee27c60fbe5ea0180455b453d5b4b Mon Sep 17 00:00:00 2001 From: josemartinez Date: Sat, 21 Mar 2020 20:51:52 +0100 Subject: [PATCH] Translate working with cookies to spanish --- .../working_with_cookies.es.md | 203 +++++++++--------- 1 file changed, 102 insertions(+), 101 deletions(-) diff --git a/docs_source_files/content/support_packages/working_with_cookies.es.md b/docs_source_files/content/support_packages/working_with_cookies.es.md index 629d7802e389..a7e7a1b8d227 100644 --- a/docs_source_files/content/support_packages/working_with_cookies.es.md +++ b/docs_source_files/content/support_packages/working_with_cookies.es.md @@ -1,29 +1,27 @@ --- -title: "Working with cookies" +title: "Trabajando con las cookies" weight: 6 --- - -{{% notice info %}} - Page being translated from -English to Spanish. Do you speak Spanish? Help us to translate -it by sending us pull requests! -{{% /notice %}} - -A cookie is a small piece of data that is sent from a website and stored in your computer. -Cookies are mostly used to recognise the user and load the stored information. - -WebDriver API provides a way to interact with cookies with built-in methods: - -## Add Cookie -It is used to add a cookie to the current browsing context. -Add Cookie only accepts a set of defined serializable JSON object. Here -is the link to the list of accepted JSON key values - -First of all, you need to be on the domain that the cookie will be -valid for. If you are trying to preset cookies before -you start interacting with a site and your homepage is large / takes a while to load -an alternative is to find a smaller page on the site (typically the 404 page is small, -e.g. http://example.com/some404page) + +Una cookie es una pequeña pieza de datos que es enviada desde el sitio web y es +almacenada en el ordenador. +Las cookies son usadas principalmente para reconocer al usuario y cargar la información +almacenada. + +El API de WebDriver proporciona una forma de interactuar con las cookies a través +de métodos incorporados como: + +## Añadir una Cookie +Este método es usado para añadir una cookie al contexto actual del navegador. +Este método solo acepta un conjunto de objetos JSON serializables definidos. +En este enlace esta la +lista de claves valor JSON que son aceptadas. + +Lo primero de todo, necesitas estar en el dominio para el que la cookie es valida. +Si intentas añadir un conjunto de cookies preestablecidas antes de empezar a +interactuar con el sitio web y la pagina de inicio es muy pesada o tarda demasiado +en cargar una alternativa es encontrar una pagina mas pequeña en el sitio (típicamente +la pagina del error 404 es liviana ej. http://example.com/some404page) {{< code-tab >}} {{< code-panel language="java" >}} @@ -36,7 +34,7 @@ public class addCookie { try { driver.get("http://www.example.com"); - // Adds the cookie into current browser context + // Añade una cookie al contexto actual del navegador driver.manage().addCookie(new Cookie("key", "value")); } finally { driver.quit(); @@ -51,7 +49,7 @@ driver = webdriver.Chrome() driver.get("http://www.example.com") -# Adds the cookie into current browser context +# Añade una cookie al contexto actual del navegador driver.add_cookie({"name": "key", "value": "value"}) {{< / code-panel >}} {{< code-panel language="csharp" >}} @@ -63,10 +61,10 @@ namespace AddCookie { public static void Main(string[] args) { IWebDriver driver = new ChromeDriver(); try { - // Navigate to Url + // Navega a la URL driver.Navigate().GoToUrl("https://example.com"); - // Adds the cookie into current browser context + // Añade una cookie al contexto actual del navegador driver.Manage().Cookies.AddCookie(new Cookie("key", "value")); } finally { driver.Quit(); @@ -82,7 +80,7 @@ driver = Selenium::WebDriver.for :chrome begin driver.get 'https://www.example.com' - # Adds the cookie into current browser context + # Añade una cookie al contexto actual del navegador driver.manage.add_cookie(name: "key", value: "value") ensure driver.quit @@ -97,7 +95,7 @@ const {Builder} = require('selenium-webdriver'); await driver.get('https://www.example.com'); - // set a cookie on the current domain + // Añade una cookie al contexto actual del navegador await driver.manage().addCookie({name:'key', value: 'value'}); })(); {{< / code-panel >}} @@ -110,7 +108,7 @@ fun main() { try { driver.get("https://example.com") - // Adds the cookie into current browser context + // Añade una cookie al contexto actual del navegador driver.manage().addCookie(Cookie("key", "value")); } finally { driver.quit() @@ -119,9 +117,10 @@ fun main() { {{< / code-panel >}} {{< / code-tab >}} -## Get Named Cookie +## Obtener una cookie por nombre -It returns the serialized cookie data matching with the cookie name among all associated cookies. +Devuelve la información de la cookie serializada que concuerda con el nombre de +la cookie entre todas las cookies asociadas. {{< code-tab >}} {{< code-panel language="java" >}} @@ -135,7 +134,7 @@ public class getCookieNamed { driver.get("http://www.example.com"); driver.manage().addCookie(new Cookie("foo", "bar")); - // Get cookie details with named cookie 'foo' + // Obtiene los detalles de la cookie con el nombre 'foo' Cookie cookie1 = driver.manage().getCookieNamed("foo"); System.out.println(cookie1); } finally { @@ -149,13 +148,13 @@ from selenium import webdriver driver = webdriver.Chrome() -# Navigate to url +# Navega a la URL driver.get("http://www.example.com") -# Adds the cookie into current browser context +# Añade una cookie al contexto actual del navegador driver.add_cookie({"name": "foo", "value": "bar"}) -# Get cookie details with named cookie 'foo' +# Obtiene los detalles de la cookie con el nombre 'foo' print driver.get_cookie("foo") {{< / code-panel >}} {{< code-panel language="csharp" >}} @@ -167,11 +166,11 @@ namespace GetCookieNamed { public static void Main(string[] args) { IWebDriver driver = new ChromeDriver(); try { - // Navigate to Url + // Navega a la URL driver.Navigate().GoToUrl("https://example.com"); driver.Manage().Cookies.AddCookie(new Cookie("foo", "bar")); - // Get cookie details with named cookie 'foo' + // Obtiene los detalles de la cookie con el nombre 'foo' var cookie = driver.Manage().Cookies.GetCookieNamed("foo"); System.Console.WriteLine(cookie); } finally { @@ -189,7 +188,7 @@ begin driver.get 'https://www.example.com' driver.manage.add_cookie(name: "foo", value: "bar") - # Get cookie details with named cookie 'foo' + # Obtiene los detalles de la cookie con el nombre 'foo' puts driver.manage.cookie_named('foo') ensure driver.quit @@ -204,10 +203,10 @@ const {Builder} = require('selenium-webdriver'); await driver.get('https://www.example.com'); - // set a cookie on the current domain + // Añade una cookie en el dominio actual await driver.manage().addCookie({name:'foo', value: 'bar'}); - // Get cookie details with named cookie 'foo' + // Obtiene los detalles de la cookie con el nombre 'foo' driver.manage().getCookie('foo').then(function (cookie) { console.log('cookie details => ', cookie); }); @@ -223,7 +222,7 @@ fun main() { driver.get("https://example.com") driver.manage().addCookie(Cookie("foo", "bar")); - // Get cookie details with named cookie 'foo' + // Obtiene los detalles de la cookie con el nombre 'foo' val cookie = driver.manage().getCookieNamed("foo"); println(cookie); } finally { @@ -233,10 +232,11 @@ fun main() { {{< / code-panel >}} {{< / code-tab >}} -## Get All Cookies +## Obtener todas las cookies -It returns a ‘successful serialized cookie data’ for current browsing context. -If browser is no longer available it returns error. +Devuelve la información serializada de las cookies de manera satisfactoria para +el contexto actual del navegador. +Si el navegador no esta disponible devolverá un error. {{< code-tab >}} {{< code-panel language="java" >}} @@ -249,11 +249,11 @@ public class getAllCookies { WebDriver driver = new ChromeDriver(); try { driver.get("http://www.example.com"); - // Add few cookies + // Añade varias cookies driver.manage().addCookie(new Cookie("test1", "cookie1")); driver.manage().addCookie(new Cookie("test2", "cookie2")); - // Get All available cookies + // Obtiene todas las cookies disponibles Set cookies = driver.manage().getCookies(); System.out.println(cookies); } finally { @@ -267,13 +267,13 @@ from selenium import webdriver driver = webdriver.Chrome() -# Navigate to url +# Navega a la URL driver.get("http://www.example.com") driver.add_cookie({"name": "test1", "value": "cookie1"}) driver.add_cookie({"name": "test2", "value": "cookie2"}) -# Get all available cookies +# Obtiene todas las cookies disponibles print driver.get_cookies() {{< / code-panel >}} {{< code-panel language="csharp" >}} @@ -285,12 +285,12 @@ namespace GetAllCookies { public static void Main(string[] args) { IWebDriver driver = new ChromeDriver(); try { - // Navigate to Url + // Navega a la URL driver.Navigate().GoToUrl("https://example.com"); driver.Manage().Cookies.AddCookie(new Cookie("test1", "cookie1")); driver.Manage().Cookies.AddCookie(new Cookie("test2", "cookie2")); - // Get All available cookies + // Obtiene todas las cookies disponibles var cookies = driver.Manage().Cookies.AllCookies; } finally { driver.Quit(); @@ -308,7 +308,7 @@ begin driver.manage.add_cookie(name: "test1", value: "cookie1") driver.manage.add_cookie(name: "test2", value: "cookie2") - # Get all available cookies + # Obtiene todas las cookies disponibles puts driver.manage.all_cookies ensure driver.quit @@ -323,11 +323,11 @@ const {Builder} = require('selenium-webdriver'); await driver.get('https://www.example.com'); - // Add few cookies + // Añade varias cookies await driver.manage().addCookie({name:'test1', value:'cookie1'}); await driver.manage().addCookie({name:'test2', value:'cookie2'}); - // Get all Available cookies + // Obtiene todas las cookies disponibles driver.manage().getCookies().then(function (cookies) { console.log('cookie details => ', cookies); }); @@ -344,7 +344,7 @@ fun main() { driver.manage().addCookie(Cookie("test1", "cookie1")); driver.manage().addCookie(Cookie("test2", "cookie2")); - // Get All available cookies + // Obtiene todas las cookies disponibles val cookies = driver.manage().cookies; println(cookies); } finally { @@ -355,9 +355,9 @@ fun main() { {{< / code-tab >}} -## Delete Cookie +## Borrado de una Cookie -It deletes the cookie data matching with the provided cookie name. +Borra la información de la cookie que coincida con el nombre de la cookie proporcionado. {{< code-tab >}} {{< code-panel language="java" >}} @@ -373,12 +373,12 @@ public class deleteCookie { Cookie cookie1 = new Cookie("test2", "cookie2"); driver.manage().addCookie(cookie1); - // delete a cookie with name 'test1' + // Borra la cookie con el nombre 'test1' driver.manage().deleteCookieNamed("test1"); /* - Selenium Java bindings also provides a way to delete - cookie by passing cookie object of current browsing context + Selenium Java tambien proporciona una forma de borrar cookies + pasando un objeto cookie del contexto actual del navegador. */ driver.manage().deleteCookie(cookie1); } finally { @@ -391,12 +391,12 @@ public class deleteCookie { from selenium import webdriver driver = webdriver.Chrome() -# Navigate to url +# Navega a la URL driver.get("http://www.example.com") driver.add_cookie({"name": "test1", "value": "cookie1"}) driver.add_cookie({"name": "test2", "value": "cookie2"}) -# Delete a cookie with name 'test1' +# Borra la cookie con el nombre 'test1' driver.delete_cookie("test1") {{< / code-panel >}} {{< code-panel language="csharp" >}} @@ -408,17 +408,17 @@ namespace DeleteCookie { public static void Main(string[] args) { IWebDriver driver = new ChromeDriver(); try { - // Navigate to Url + // Navega a la URL driver.Navigate().GoToUrl("https://example.com"); driver.Manage().Cookies.AddCookie(new Cookie("test1", "cookie1")); var cookie = new Cookie("test2", "cookie2"); driver.Manage().Cookies.AddCookie(cookie); - // delete a cookie with name 'test1' + // Borra la cookie con el nombre 'test1' driver.Manage().Cookies.DeleteCookieNamed("test1"); - // Selenium .net bindings also provides a way to delete - // cookie by passing cookie object of current browsing context + // Selenium .Net tambien proporciona una forma de borrar cookies + // pasando un objeto cookie del contexto actual del navegador. driver.Manage().Cookies.DeleteCookie(cookie); } finally { driver.Quit(); @@ -436,7 +436,7 @@ begin driver.manage.add_cookie(name: "test1", value: "cookie1") driver.manage.add_cookie(name: "test2", value: "cookie2") - # delete a cookie with name 'test1' + # Borra la cookie con el nombre 'test1' driver.manage.delete_cookie('test1') ensure driver.quit @@ -451,14 +451,14 @@ const {Builder} = require('selenium-webdriver'); await driver.get('https://www.example.com'); - // Add few cookies + // Añade varias cookies await driver.manage().addCookie({name:'test1', value:'cookie1'}); await driver.manage().addCookie({name:'test2', value:'cookie2'}); - // Delete a cookie with name 'test1' + // Borra la cookie con el nombre 'test1' await driver.manage().deleteCookie('test1'); - // Get all Available cookies + // Muestra todas las cookies disponibles driver.manage().getCookies().then(function (cookies) { console.log('cookie details => ', cookies); }); @@ -476,10 +476,10 @@ fun main() { val cookie1 = Cookie("test2", "cookie2") driver.manage().addCookie(cookie1); - // delete a cookie with name 'test1' + // Borra la cookie con el nombre 'test1' driver.manage().deleteCookieNamed("test1"); - // delete cookie by passing cookie object of current browsing context. + // Borra una cookie pasando un objeto cookie del contexto actual del navegador. driver.manage().deleteCookie(cookie1); } finally { driver.quit() @@ -489,9 +489,9 @@ fun main() { {{< / code-tab >}} -## Delete All Cookies +## Borra todas las Cookies -It deletes all the cookies of the current browsing context. +Borra todas las cookies del contexto actual del navegador. {{< code-tab >}} {{< code-panel language="java" >}} @@ -506,7 +506,7 @@ public class deleteAllCookies { driver.manage().addCookie(new Cookie("test1", "cookie1")); driver.manage().addCookie(new Cookie("test2", "cookie2")); - // deletes all cookies + // Borra todas las cookies driver.manage().deleteAllCookies(); } finally { driver.quit(); @@ -518,12 +518,12 @@ public class deleteAllCookies { from selenium import webdriver driver = webdriver.Chrome() -# Navigate to url +# Navega a la URL driver.get("http://www.example.com") driver.add_cookie({"name": "test1", "value": "cookie1"}) driver.add_cookie({"name": "test2", "value": "cookie2"}) -# Deletes all cookies +# Borra todas las cookies driver.delete_all_cookies() {{< / code-panel >}} {{< code-panel language="csharp" >}} @@ -535,12 +535,12 @@ namespace DeleteAllCookies { public static void Main(string[] args) { IWebDriver driver = new ChromeDriver(); try { - // Navigate to Url + // Navega a la URL driver.Navigate().GoToUrl("https://example.com"); driver.Manage().Cookies.AddCookie(new Cookie("test1", "cookie1")); driver.Manage().Cookies.AddCookie(new Cookie("test2", "cookie2")); - // deletes all cookies + // Borra todas las cookies driver.Manage().Cookies.DeleteAllCookies(); } finally { driver.Quit(); @@ -558,7 +558,7 @@ begin driver.manage.add_cookie(name: "test1", value: "cookie1") driver.manage.add_cookie(name: "test2", value: "cookie2") - # deletes all cookies + # Borra todas las cookies driver.manage.delete_all_cookies ensure driver.quit @@ -573,11 +573,11 @@ const {Builder} = require('selenium-webdriver'); await driver.get('https://www.example.com'); - // Add few cookies + // Añade varias cookies await driver.manage().addCookie({name:'test1', value:'cookie1'}); await driver.manage().addCookie({name:'test2', value:'cookie2'}); - // Delete all cookies + // Borra todas las cookies await driver.manage().deleteAllCookies(); })(); {{< / code-panel >}} @@ -592,7 +592,7 @@ fun main() { driver.manage().addCookie(Cookie("test1", "cookie1")); driver.manage().addCookie(Cookie("test2", "cookie2")); - // deletes all cookies + // Borra todas las cookies driver.manage().deleteAllCookies(); } finally { driver.quit() @@ -602,25 +602,24 @@ fun main() { {{< / code-tab >}} -## Same-Site Cookie Attribute +## El Atributo Same-Site cookie -It allows a user to instruct browsers to control whether cookies -are sent along with the request initiated by third party sites. -It is introduced to prevent CSRF (Cross-Site Request Forgery) attacks. +Este atributo permite al usuario enseñar a los navegadores a controlar que cookies +son mandadas junto con las peticiones iniciadas por servicios externos. +Esto introducido con la intención de prevenir ataques CSRF (_Cross-Site Request Forgery_) +El atributo Same-Site acepta dos parámetros como instrucciones: -Same-Site cookie attribute accepts two parameters as instructions +## Estricto: +Cuando el atributo sameSite esta fijado como **Strict** (estricto en español), +la cookie no será enviada junto a las peticiones iniciadas por paginas web externas. -## Strict: -When the sameSite attribute is set as **Strict**, -the cookie will not be sent along with -requests initiated by third party websites. +## Laxo: +Cuando el atributo sameSite se fija como **Lax** (Laxo en español), +la cookie será enviada junto con la petición GET iniciada por paginas web externas. -## Lax: -When you set a cookie sameSite attribute to **Lax**, -the cookie will be sent along with the GET -request initiated by third party website. -**Note**: **As of now this feature is landed in chrome(80+version) and works with Selenium 4 and later versions.** +**Nota**: **Ahora mismo esta característica esta disponible en la versión 80 y +superiores de chrome funcionando con Selenium 4 y versiones posteriores.** {{< code-tab >}} {{< code-panel language="java" >}} @@ -650,7 +649,8 @@ from selenium import webdriver driver = webdriver.Chrome() driver.get("http://www.example.com") -# Adds the cookie into current browser context with sameSite 'Strict' (or) 'Lax' +# Añade la cookie en el contexto actual del navegador con el parámetro +# sameSite como 'Strict' (o) 'Lax' driver.add_cookie({"name": "foo", "value": "value", 'sameSite': 'Strict'}) driver.add_cookie({"name": "foo1", "value": "value", 'sameSite': 'Lax'}) cookie1 = driver.get_cookie('foo') @@ -659,10 +659,10 @@ print cookie1 print cookie2 {{< / code-panel >}} {{< code-panel language="csharp" >}} -// Please raise a PR +// No disponemos del ejemplo de código en C# aun - Ayudanos a ello abriendo un PR {{< / code-panel >}} {{< code-panel language="ruby" >}} -# Please raise a PR +# No disponemos del ejemplo de código en Ruby aun - Ayudanos a ello abriendo un PR {{< / code-panel >}} {{< code-panel language="javascript" >}} const {Builder} = require('selenium-webdriver'); @@ -673,7 +673,8 @@ const {Builder} = require('selenium-webdriver'); await driver.get('https://www.example.com'); - // set a cookie on the current domain with sameSite 'Strict' (or) 'Lax' + // Añade la cookie en el contexto actual del navegador con el parámetro + // sameSite como 'Strict' (o) 'Lax' await driver.manage().addCookie({name:'key', value: 'value', sameSite:'Strict'}); await driver.manage().addCookie({name:'key', value: 'value', sameSite:'Lax'}); console.log(await driver.manage().getCookie('key'));