Een ontbrekend openbaar document moet een duidelijke uitleg tonen en een geschikte HTTP-statuscode teruggeven, meestal 404. Op een Mac kun je beide controleren in Chrome, de afwijking vaststellen en je publicatiesysteem een precieze correctie laten uitvoeren.

Deze werkwijze is bedoeld voor iemand die openbare documentpagina’s beheert: handleidingen, referentienotities of eenvoudige instructiebladen. Het doel is dat het opgevraagde adres, het antwoord van de server en het getoonde bericht met elkaar overeenkomen. Alle voorbeeldpaden hieronder zijn fictief.

Welke reactie moet een ontbrekend document opleveren?

Bepaal eerst wat er op het adres van het document moet gebeuren. Een pagina die is verplaatst, vraagt om een andere afhandeling dan een pagina die niet meer bestaat. Gebruik deze beslistabel voordat je het ontwerp voor ontbrekende pagina’s aanpast.

Status van het document Beoogde reactie Wat lezers moeten zien
Het bestaat op het opgevraagde adres 200 OK Het volledige document
Het heeft een duidelijke permanente vervanging 301-omleiding Het vervangende document op het nieuwe adres
Het kan niet worden gevonden en er is geen gelijkwaardige vervanging 404 Not Found Een nuttige uitleg dat het document ontbreekt
Het is bewust verwijderd en de afwezigheid is waarschijnlijk permanent 410 Gone is passend Een duidelijke uitleg over de verwijdering en nuttige navigatie

HTTP definieert 404 zonder aan te geven of de afwezigheid tijdelijk of permanent is. 410 is bedoeld voor een bron waarvan de onbeschikbaarheid waarschijnlijk permanent is; als niet bekend is of dat permanent is, gebruik je 404. Deze betekenissen staan in RFC 9110, secties 15.5.5 en 15.5.11.

Google raadt een permanente omleiding aan als een document is verplaatst of een duidelijke vervanging heeft. Als het is verwijderd zonder een vergelijkbare vervanging, raadt Google 404 of 410 aan. Zie Googles richtlijnen voor het oplossen van reacties bij ontbrekende inhoud.

Stel bijvoorbeeld dat /documents/paper-folding-notes is vervangen door /documents/paper-folding-guide, met grotendeels gelijkwaardige instructies. Een permanente omleiding past bij die wijziging. Als de notities zonder vervanging zijn verwijderd, laat dan op het oude adres een reactie voor een ontbrekend document staan. Je kunt op die pagina een algemene documentmap als link aanbieden.

Waarom een overtuigend ontwerp voor een ontbrekende pagina niet volstaat

Een pagina kan zichtbaar Document not found tonen terwijl de server 200 teruggeeft. Google noemt dit soort afwijking een soft 404; ook een lege pagina of een pagina zonder hoofdinhoud kan zo worden geclassificeerd. Lees Googles uitleg over soft 404-fouten.

De status maakt deel uit van het HTTP-antwoord en staat los van de uitleg op de pagina. Daarom stelt het wijzigen van de kop of het toevoegen van een groot label 404 de antwoordcode niet in. Controleer het daadwerkelijke documentverzoek voordat je besluit dat het probleem is opgelost. RFC 9110 beschrijft de rol van antwoordstatuscodes.

Hoe controleer je het documentantwoord op een Mac?

Gebruik hiervoor de ingebouwde hulpmiddelen van Chrome. Zorg voor één bekend werkend documentadres en één bewust niet-bestaand pad op dezelfde openbare site. Het ontbrekende pad kan bijvoorbeeld /documents/missing-paper-example-731 zijn. Kies een adres waarvan je weet dat er geen document is gepubliceerd.

  1. Open de openbare pagina in Chrome.
  2. Druk op Command + Option + I om DevTools te openen.
  3. Selecteer het paneel Network.
  4. Voer met DevTools geopend het testadres in de adresbalk in en laad het.

Chrome vermeldt de Mac-sneltoets in Chrome DevTools openen. Netwerkactiviteit wordt vastgelegd zolang DevTools open is, zoals uitgelegd in het overzicht van het paneel Network.

  1. Selecteer Disable cache zodat je tijdens deze controle niet afhankelijk bent van het antwoord in de browsercache.
  2. Schakel Preserve log in als je bij omleidingen de navigatie wilt volgen.
  3. Laad het testadres opnieuw.
  4. Selecteer het hoofdverzoek voor het document en open vervolgens Headers. Lees onder General het opgevraagde adres en de statuscode af.

Deze bedieningselementen en de locatie van de statusinformatie zijn beschreven in de referentie voor Network-functies van Chrome.

Controleer het documentverzoek zorgvuldig. Het logboek bevat ook verzoeken voor scripts, stijlen en andere bronnen. Een ontbrekend ondersteunend bestand bewijst niet dat het document zelf 404 heeft teruggegeven. In de verzoekentabel van Chrome staan de HTTP-code onder Status en de broncategorie onder Type; zie Netwerkactiviteit inspecteren.

Vergelijk nu drie waarnemingen: het oorspronkelijk opgevraagde adres, de antwoordcode voor dat document en de pagina die na het laden zichtbaar is. Noteer ze samen. Als de navigatie het adres wijzigt, inspecteer dan zowel het oorspronkelijke verzoek als de bestemming, in plaats van alleen de uiteindelijke pagina te noteren.

Hoe zet je de waarnemingen om in een correctie?

De volgende diagnosetabel is een praktische samenvatting van de HTTP-betekenissen en Googles richtlijnen voor probleemoplossing. Het is een hulpmiddel bij het nemen van beslissingen, geen overzicht van gemeten resultaten.

Waargenomen resultaat Wat je moet onderzoeken Beoogde correctie
200 met een bericht dat het document ontbreekt De afhandeling van ontbrekende routes of de fallback Geef 404 terug met de uitleg
404 terwijl het verwachte document zichtbaar is Het antwoord dat aan een bestaande route is toegewezen Lever het document succesvol met 200
Een omleiding naar een algemene map Of er een gelijkwaardige vervanging bestaat Leid om naar het gelijkwaardige document of toon een pagina voor ontbrekende documenten
200 met een leeg of onvolledig document Het laden en weergeven van inhoud Herstel de bedoelde inhoud als het document nog bestaat
404 met een nuttig bericht over de ontbrekende pagina Of het adres daadwerkelijk ontbreekt Behoud dit gedrag als de afwezigheid bedoeld is

In de documentatie voor probleemoplossing maakt Google expliciet onderscheid tussen documenten die niet beschikbaar zijn, documenten die zijn verplaatst en documenten die nog bestaan maar niet goed laden. Dat onderscheid voorkomt dat een onvolledig werkende pagina wordt behandeld alsof die bewust is verwijderd. Zie Problemen met crawlfouten in Google Search oplossen.

Schrijf voor een concrete overdracht bijvoorbeeld: “Geef voor het fictieve ontbrekende pad /documents/missing-paper-example-731 404 terug en toon op dat adres de aangepaste pagina voor het ontbrekende document. Laat bestaande documentpaden succesvol werken. Gebruik permanente omleidingen alleen wanneer een gelijkwaardige vervanging is vastgesteld.” Voeg de waargenomen status en het zichtbare bericht van je controle toe.

Met dat verzoek beschrijf je het vereiste gedrag zonder te gokken naar de menunamen van je publicatiesysteem. De implementatie hoort thuis in de hostingconfiguratie, de applicatieroute of het publicatiesysteem dat het antwoord genereert. Google legt in de documentatie over HTTP-statuscodes uit dat HTTP-statuscodes door de hostingserver worden gegenereerd.

Wat als je in de editor alleen de pagina-inhoud kunt wijzigen?

Een editor waarmee je tekst of documentmetadata kunt wijzigen, heeft mogelijk geen invloed op HTTP-antwoorden. De WHATWG HTML Standard definieert specifiek gedrag voor meta-richtlijnen met http-equiv; het instellen van een HTTP-antwoordstatus hoort daar niet bij. http-equiv="status" toevoegen is dus geen ondersteunde manier om een 404 te maken. Zie HTML Standard: pragma-richtlijnen.

Als je in de editor geen antwoordinstellingen kunt wijzigen, gebruik dan het gedocumenteerde mechanisme voor ontbrekende pagina’s van de hosting- of applicatielaag. Vraag of dat de aangepaste inhoud op het opgevraagde ontbrekende adres met 404 aanbiedt. Een instelling waarmee je alleen de indeling van de foutpagina kiest, geeft geen antwoord op die vraag; controleer het resultaat met de browserwerkwijze.

Een gedocumenteerd voorbeeld voor statische pagina’s op Netlify

Voor een bestaande statische site op Netlify is het gedocumenteerde mechanisme een bestand met de naam 404.html. Netlify gebruikt dit automatisch voor paden die niet naar een statisch bestand verwijzen. Dit is een providerspecifiek voorbeeld, met voorwaarden: je moet toegang hebben tot de voltooide site-uitvoer en er moet al een build van statische pagina’s bestaan. Netlify documenteert de afhandeling van aangepaste 404-pagina’s.

  1. Maak met de bestaande paginasjabloon van de site de pagina voor het ontbrekende document.
  2. Zorg dat de voltooide uitvoer 404.html bevat in de hoofdmap van de publicatiemap.
  3. Controleer of een eerdere routeringsregel onbekende adressen naar een andere pagina stuurt.
  4. Inspecteer na publicatie van de aangepaste uitvoer op het openbare adres zowel een ontbrekend pad als een werkend document.

Die routeringscontrole is belangrijk, omdat Netlify de routering afhandelt voordat het statische bestanden en uiteindelijk de ontbrekende pagina verwerkt. Een verzoek dat eerder wordt afgehandeld, bereikt die uiteindelijke afhandeling niet. De documentatie over Request Chain legt de volgorde uit. Dit voorbeeld beschrijft een mogelijke correctie; het betekent niet dat er een site is gewijzigd.

De grens bij applicaties die vanuit de browser worden gerouteerd

Sommige applicaties ontdekken pas na het uitvoeren van JavaScript dat een document ontbreekt. Google erkent dat betekenisvolle statuscodes bij routering aan de clientzijde lastig kunnen zijn. De gedocumenteerde alternatieven zijn een JavaScript-omleiding naar een adres waarvan de server 404 teruggeeft, of het toevoegen van metadata noindex aan de foutpagina. Zie Googles richtlijnen voor JavaScript-SEO.

Deze alternatieven hebben verschillende gevolgen. De omleiding gaat naar een nieuw adres met een echte reactie voor een ontbrekende pagina. De metadatamethode is bedoeld voor indexering, maar laat de oorspronkelijke HTTP-status ongewijzigd. Als het vereiste is om het oorspronkelijke documentadres te behouden en daar 404 terug te geven, moet de hosting- of applicatiereactie dat ondersteunen.

Wat moet de pagina voor een ontbrekend document zeggen?

Gebruik een korte, specifieke melding zoals This document could not be found. Voeg er één nuttige vervolgstap aan toe: een link naar de documentmap of een andere gecontroleerde navigatiebestemming. Behoud de vertrouwde navigatie en vormgeving van de site. Google raadt duidelijke taal, een consistente vormgeving en nuttige links aan voor aangepaste ontbrekende pagina’s.

Voor het fictieve voorbeeld met de vouwinstructies zou deze tekst geschikt zijn: We couldn’t find this paper-folding document. Browse the document directory to choose another guide. Beschrijf een document alleen als permanent verwijderd wanneer dat bekend is. Houd de uitleg zichtbaar in plaats van elk ontbrekend adres meteen ergens anders naartoe te sturen.

Hoe controleer je of het antwoord en de pagina overeenkomen?

Herhaal de inspectie met een kleine vergelijkingsset. De verwachte uitkomsten hieronder zijn voorbeelden van acceptatiecriteria; het zijn geen gerapporteerde testresultaten.

Testgeval Verwacht antwoord en verwachte pagina
Bekend werkend document 200 met het volledige document
Bewust niet-bestaand pad 404 met de uitleg dat het document ontbreekt
Verwijderd document zonder vervanging 404, of indien passend 410, met een juiste uitleg
Verplaatst document met een gelijkwaardige vervanging Permanente omleiding, gevolgd door een succesvol antwoord van de vervanging

Test opnieuw door elk adres rechtstreeks in te voeren en opnieuw te laden, ook documenten die je normaal via navigatie op de pagina bereikt. Zo controleer je welk antwoord een nieuw documentverzoek krijgt. Noteer het adres, de code en het zichtbare resultaat samen, zodat een succesvolle bestemming een onjuist antwoord eerder in de navigatie niet verbergt.

Als een oud resultaat blijft staan, maak dan onderscheid tussen de browsercache en andere caches. Het uitschakelen van Chrome’s cache geldt voor de browsercache. HTTP-caching kan ook negatieve antwoorden opslaan, zoals 404; daarom kan het nodig zijn om het gedocumenteerde cachegedrag van het publicatiesysteem te controleren als een verouderd antwoord voor een ontbrekend document blijft staan. RFC 9111 legt uit dat negatieve resultaten in de cache kunnen worden opgeslagen.

Voor Google Search heeft een echte reactie voor een ontbrekend document een beoogd gevolg: Google indexeert URL’s die 404 of 410 teruggeven niet, en eerder geïndexeerde URL’s worden verwijderd wanneer die reacties worden verwerkt. Ook een succesvol antwoord 200 garandeert geen indexering. Zie De invloed van HTTP-statuscodes op de crawlers van Google.

Rond de controle af wanneer elk getest adres een samenhangend verhaal vertelt: beschikbare documenten laden goed, verplaatste documenten leiden naar hun vervanging en ontbrekende documenten geven een passende reactie met nuttige navigatie. Zo heb je op je Mac een concrete en herhaalbare publicatiecontrole.

Bronnen