Teknika Zerbitzari-scriptak WCAG 2.2
SVR1Birbideratze automatikoak zerbitzarian egitea, ez orrian
Izen ofiziala W3Cn: Birbideratze automatikoak zerbitzarian ezartzea, bezeroan ezarri beharrean
Laburbilduz
Web-helbide bat aldatzen denean, pertsona automatikoki eraman behar da helbide berrira. Birbideratze hori zerbitzariak egin behar du, HTTP 301 edo 302 erantzun batekin. Ez da egin behar meta refresh etiketa batekin, ezta orria aldatzen duen script batekin ere.
Zergatik da garrantzitsua
Orri zaharra kargatu eta segundo batzuk geroago beste batera jauzi egiten badu, pertsona desorientatu egiten da. Pantaila-irakurgailua (edukia ozen irakurtzen duen programa) erabiltzen duena lehen orria entzuten ari izan daiteke bat-batean aldatzen denean.
Zerbitzariak birbideratzen duenean, nabigatzailea zuzenean joaten da orri berrira. Ez dago ustekabeko aldaketarik, eta hori da, hain zuzen, 3.2.5 irizpideak eskatzen duena.
Nola egiten da
- Erabili
301kodea aldaketa iraunkorra bada; adibidez, egoitza elektronikoak helbidez aldatzen duenean. Erabili302aldi baterakoa bada. - Apache-n, gehitu arau bat konfigurazioan edo
.htaccessfitxategian; adibidez,Redirect 301 /tramites /sede/tramites. - PHPn, bidali goiburua beste edozein edukiren aurretik:
header('Location: /nueva-pagina', true, 301); - Beste ingurune batzuetan (Java, ASP, Node.js…), erabili zerbitzariaren beraren birbideratze-funtzioa.
- Kendu orrietatik
meta refreshetiketak eta kargatzean birbideratzen duten scriptak.
Nola egiaztatu
- Ireki nabigatzailearen garapen-tresnak (F12 tekla) eta joan Sarea fitxara.
- Bisitatu helbide zaharra eta bilatu haren erantzuna.
301edo302kodea eta helbide berria duenLocationgoiburua izan behar ditu. - Berrikusi orrien iturburu-kodea. Baieztatu ez dagoela
meta refreshbidezko birbideratzerik, ezta JavaScripteko tenporizadoreen bidezkorik ere.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SVR1 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Zerbitzariaren aldeko teknologiak, zerbitzariaren aldeko script-lengoaiak eta birbideratzeetarako URLak edo URL ereduak dituzten zerbitzariaren konfigurazio-fitxategiak barne.
Deskribapena
Teknika honen helburua da bi orri berri segidan azkar kargatzen direnean sor daitekeen nahasmena saihestea, orri batek (erabiltzaileak eskatutakoak) beste batera birbideratzen duelako. Erabiltzaile-agente batzuek HTMLko meta elementua erabiltzea onartzen dute, erabiltzailea beste orri batera birbideratzeko segundo kopuru jakin baten ondoren. Horren ondorioz, orria ez da irisgarria erabiltzaile batzuentzat, batez ere pantaila-irakurgailuak erabiltzen dituztenentzat. Zerbitzariaren aldeko teknologiek erabiltzaileak nahasten ez dituen moduan birbideratzeak ezartzeko metodoak eskaintzen dituzte. Zerbitzariaren aldeko script edo konfigurazio-fitxategi batek zerbitzariak HTTP erantzun egoki bat bidaltzea eragin dezake, 3xx tarteko egoera-kode batekin eta beste URL bat duen Location goiburu batekin. Nabigatzaileak erantzun hori jasotzen duenean, helbide-barra aldatu egiten da eta nabigatzaileak eskaera bat egiten du URL berriarekin.
Adibideak
JSP/Servlets
Java Servlets edo JavaServer Pages (JSP) teknologietan, garatzaileek HttpServletResponse.sendRedirect(String url) erabil dezakete.
...
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
...
response.sendRedirect("/newUserLogin.do");
}
Horrek erabiltzaile-agenteari 302 egoera-kodea («Found», aurkitua) eta URL berria duen Location goiburu bat dituen erantzun bat bidaltzen dio. Beste egoera-kode bat ezartzea ere posible da response.sendError(int code, String message) erabiliz, javax.servlet.http.HttpServletResponse interfazean definitutako konstanteetako bat egoera-kode gisa erabilita.
...
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
...
response.sendError(response.SC_MOVED_PERMANENTLY, "/newUserLogin.do");
}
Aplikazio batek HttpServletResponse.encodeURL(String
url) erabiltzen badu URLak berridazteko, aplikazioa saioen mende dagoelako, HttpServletResponse.encodeRedirectURL(String url) metodoa erabili behar da HttpServletResponse.sendRedirect(String url) metodoaren ordez. URL bat HttpServletResponse.encodeURL(String url) metodoarekin berridaztea eta, ondoren, URL hori HttpServletResponse.sendRedirect(String url) metodoari pasatzea ere posible da.
ASP
VBScript-ekin idatzitako Active Server Pages (ASP) orrietan, garatzaileek Response.Redirect erabil dezakete.
Response.Redirect "newUserLogin.asp"
edo
Response.Redirect("newUserLogin.asp")
Ondorengo kodea adibide osoagoa da, HTTP egoera-kode jakin batekin.
Response.Clear
Response.Status = 301
Response.AddHeader "Location", "newUserLogin.asp"
Response.Flush
Response.End
PHP
PHPn, garatzaileek prozesatu gabeko HTTP goiburu bat bidal dezakete header metodoarekin. Ondorengo kodeak 301 egoera-kode bat eta kokapen berri bat bidaltzen ditu. Egoera esplizituki ezartzen ez bada, birbideratze-erantzunak 302 HTTP egoera-kodea bidaltzen du.
<?php
header("HTTP/1.1 301 Moved Permanently");
header("Location: https://www.example.com/newUserLogin.php");
?>
Apache
Garatzaileek Apache web-zerbitzaria konfigura dezakete birbideratzeak kudea ditzan, ondorengo adibidean bezala.
redirect 301 /oldUserLogin.jsp https://www.example.com/newUserLogin.do
Probak
Prozedura
- Aurkitu beste orri edo web-orri baterako esteka edo erreferentzia programatiko bakoitza.
- Ebaluatzen ari den web-orrien multzoaren barruko URI baterako esteka edo erreferentzia programatiko bakoitzerako, egiaztatu erreferentziatutako web-orriak bezeroaren aldeko birbideratze bat eragiten duen koderik (adibidez, meta elementu bat edo script bat) duen.
- Ebaluatzen ari den web-orrien multzoaren barruko URI baterako esteka edo erreferentzia programatiko bakoitzerako, egiaztatu erreferentziatutako
URIak ez duela birbideratzerik eragiten EDO zerbitzariaren aldeko birbideratze bat eragiten duela itxaron-denborarik gabe.
Espero diren emaitzak
- 2. egiaztapena faltsua da eta 3. egiaztapena egiazkoa da.
Baliabideak
- Use standard redirects: do not break the back button! (W3Cren kalitate-aholkua: erabili birbideratze estandarrak eta ez hautsi «Atzera» botoia).
- RFC 9110: HTTP Semantics 15.4. Redirection 3xx.
- Interface javax.servlet.http.HttpServletResponse, Java Servlets 6 APIaren dokumentazioan.
- PHP header (PHPren header funtzioa).
- Apache Module mod_alias orriak, Apache HTTP Server 2.4 bertsioaren dokumentazioan, birbideratzeak Apache 2.4-n nola zehaztu daitezkeen deskribatzen du.
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SVR1 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.