HEAD isteği ne işe yarar?
HTTP HEAD, GET ile alınacak seçili temsil hakkında üstbilgi ister; sunucu yanıtın içerik gövdesini göndermez. Büyük bir dosyanın türünü veya varsa uzunluğunu okumak, bağlantıyı kontrol etmek ve bir doğrulayıcıyı incelemek için kullanılabilir.
Bu, GET yanıtını indirip sonradan kullanmamaktan farklıdır. RFC 9110 HEAD tanımı gövde gönderilmemesini zorunlu kılar. Üstbilgilerin GET ile aynı olması beklenir; ancak yalnızca gövde üretilirken hesaplanabilen bazı alanlar HEAD'de atlanabilir.
Aynı kaynakta GET ve HEAD nasıl görünür?
Aşağıdaki HTTP/1.1 parçaları örnektir; Date gibi ilgisiz alanlar gösterilmiyor. GET gövdesindeki hello! tam altı ASCII baytıdır.
GET /guide.txt HTTP/1.1
Host: example.test
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Length: 6
ETag: "guide-v1"
Cache-Control: max-age=60
hello!
HEAD /guide.txt HTTP/1.1
Host: example.test
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Length: 6
ETag: "guide-v1"
Cache-Control: max-age=60
HEAD'deki Content-Length: 6, bu yanıtla altı gövde baytı geldiği anlamına gelmez. GET aynı temsili gönderseydi kullanılacak uzunluğu belirtir. Başlık alanını, gerçekten okunan HEAD gövdesinin boyutuyla karşılaştırıp hatalı bir aktarım kararı vermeyin.
Content-Length yoksa kaynak bozuk mu?
Hayır. Uzunluğu önceden üretmek pahalı olabilir ve alan HEAD yanıtında bulunmayabilir. Content-Length referansı, alanın bayt uzunluğunu ve HEAD için GET ile ilişkisini açıklıyor. Alanın yokluğu, dosyanın boş olduğu anlamına gelmez.
Sıkıştırılmış bir temsilin uzunluğu, açılmış metnin JavaScript karakter sayısı değildir. Aynı URL'nin dil, içerik kodlaması veya yetkilendirme bağlamı farklı olabilir. Ön kontrolde kullandığınız istek başlıklarıyla sonraki GET'in aynı temsili seçtiğinden emin olun.
fetch ile yalnızca başlıkları okuyun
async function inspectResource(url) {
const response = await fetch(url, { method: 'HEAD' });
if (!response.ok) {
throw new Error('Resource check failed: ' + response.status);
}
return {
type: response.headers.get('content-type'),
length: response.headers.get('content-length'),
etag: response.headers.get('etag'),
};
}
Length burada metin veya null olarak bırakılıyor; eksik alanı otomatik olarak sıfıra çevirmiyoruz. HEAD yanıtında JSON veri gövdesi beklenmediğinden response.json() çağırmak uygun değildir. Başlığın application/json olması bu kuralı değiştirmez.
Farklı origin'den ETag okunamıyorsa tarayıcının CORS kurallarını da inceleyin. Access-Control-Expose-Headers, hangi yanıt başlıklarının JavaScript'e açıldığını belirler. CORS rehberi bu ayrımı istek başarısı ile başlık erişimi üzerinden anlatır.
Koşullu HEAD isteği 304 döndürebilir mi?
HEAD /guide.txt HTTP/1.1
Host: example.test
If-None-Match: "guide-v1"
HTTP/1.1 304 Not Modified
ETag: "guide-v1"
Cache-Control: max-age=60
Eşleşen doğrulayıcıyla bu yanıt mümkündür ve yine gövde içermez. Örnekteki inspectResource yardımcısı koşullu istek göndermiyor. Koşullu bir akış yazarsanız 304'ü ayrıca ele alın: fetch Response.ok yalnızca 200–299 için true olduğundan basit ok kontrolü 304'ü hata koluna götürür.
ETag ve Cache-Control rehberi, doğrulama ile taze önbellek yanıtını ayırır. Bir ön kontrol ile sonraki indirme arasında kaynak da değişebilir. HEAD sonucunu sonraki GET için değişmez bir garanti olarak kullanmayın.
Gövdesiz olması her durumda ucuz olduğu anlamına mı gelir?
Sunucu HEAD için yine yönlendirme, kimlik kontrolü veya veri sorgusu yapabilir. Aktarılan içerik azalır; sunucu hesaplamasının tamamen kalktığı sonucu çıkmaz. Uygulamanın HEAD'e 405 döndürmesi de aynı URL için GET'in 404 döndüreceğini kanıtlamaz.
İstemci yönlendirmeleri otomatik takip ediyorsa gördüğünüz son durum aradaki adımları gizleyebilir. Yönlendirme rehberi metot ve hedef kontrolünü açıklıyor. Testte GET/HEAD başlıklarını, gelen gövde baytlarını, eksik uzunluğu ve bulunamayan kaynağın durumunu ayrı ayrı kontrol edin.
Sık sorulan sorular
HEAD 404 yanıtı bir hata sayfası gövdesi gönderebilir mi? HEAD yanıtına içerik gövdesi eklenmemelidir; durum kodunu başlıklardan değerlendirin.
HEAD her zaman 200 mü döner? Hayır. Koşullar, hedef ve erişim durumu sonucu değiştirebilir.
Content-Length sıfır değilse response.text() dolu mu olmalı? Hayır. HEAD için boş gövde beklenir; alan GET temsilinin uzunluğunu açıklayabilir.

