Çapraz Kaynak Storage API'si ile tanışın

Yayınlanma tarihi: 10 Kasım 2026

Modern web uygulamaları genellikle JavaScript çerçeveleri, oyun motorları ve yapay zeka modelleri gibi büyük öğelere bağlıdır. Siteler aynı öğeleri kullanıyor olsa da her sitenin her bir öğenin kendi kopyasını indirip depolaması gerekir.

Önerilen Cross-Origin Storage API (kısaca COS) ile istemci, aradığı içeriği karma değeriyle belirtir ve belirlenen sitelerde (veya tüm sitelerde) paylaşmak için herhangi bir URL'den getirir. Bu, tam ve bilinen bir kaynağın, öğenin yayınlanmasından bağımsız olarak siteler arasında paylaşılabileceği anlamına gelir. Bu teklif, güvenlik avantajları ve güvenlik zorlukları getiriyor.

Kullanım alanları

Modelleri önbelleğe almanın ve Cache Storage API ile öğeleri önbelleğe almanın önemi hakkında ayrıntılı bilgi verdik. Cross-Origin Storage API bir adım daha ileri gider ve birden fazla ilişkili (veya başka) web sitesinin aynı kaynağa erişmesi gerektiğinde faydalı olabilir:

  • Yapay zeka modelleri: Gemma veya Llama varyantları gibi modellerin boyutu yaklaşık bir gigabayt ile onlarca gigabayt arasında değişir. COS aracılığıyla tek bir kopyanın depolanması ve alınması, büyük boyutlu yinelenen indirmeleri önler. Bu, teklifin arkasındaki temel motivasyondur.
  • Wasm modülleri: Flutter gibi çerçeveler, binlerce farklı kaynakta günde milyonlarca kez istenen ve her zaman bayt olarak aynı olan Wasm dosyaları gönderir.
  • Popüler JavaScript kitaplıkları ve çerçeveleri: Tedarikçi kodu ayrı ve bütünüyle (ör. eksiksiz, ağaç sallama uygulanmamış React kitaplığı) paketlendiğinde birden fazla uygulama, COS aracılığıyla önbelleğe alınmış tek bir kopyayı paylaşabilir.
  • Oyun motorları: Godot veya Unity gibi motorlar üzerine inşa edilen tarayıcı oyunları, motor çalışma zamanını COS aracılığıyla paylaşabilir ve ağ üzerinden yalnızca oyuna özel öğeleri getirebilir. Farklı kaynaklarda veya iFrame'lerde birçok basit oyun barındıran oyun portalları bu özellikten en çok yararlananlardır.
  • Büyük web yazı tipleri: Simge yazı tipleri, emoji yazı tipleri ve geniş Unicode kapsamına sahip yazı tipleri çok sayıda sayfaya indirilir. Bunları COS aracılığıyla bir kez paylaşmak hem performansa hem de sürdürülebilirliğe yardımcı olur.

COS ile çalışmanın temel akışı

COS API, web uygulamalarının kriptografik karma ile tanımlanan kaynak sınırları genelinde dosyaları depolayıp almasını sağlayan bir navigator.crossOriginStorage.getFileHandle() yöntemi sunar. Açıklayıcıda, API ile çalışmanın temel akışını gösteren bir örnek yer alır.

COS ile denemeler yapma

API yüzeyini ve tüm entegrasyonları polyfill etmek için Chrome Web Mağazası, Firefox Eklentileri veya Safari Uygulama Mağazası'ndan bir tarayıcı uzantısı yükleyebilirsiniz.

Ardından, aynı tarayıcıda API akışını test edin.

Ekosistem ilgisi

COS, erken aşamadaki bir tekliftir ve bazı projeler, genellikle etkinleştirme işaretinin arkasında ve progresif geliştirme olarak katmanlı şekilde deneysel destek sunmaktadır:

  • Emscripten, oluşturulan Wasm çıkışını paylaşır.
  • Flutter, Skia Wasm çalışma zamanını paylaşır.
  • Transformers.js, model ağırlıklarını ve bağlı oldukları Wasm çalışma zamanlarını paylaşır.
  • WebLLM, modelleri ve çalışma zamanlarını paylaşır.
  • wllama, yapay zeka modellerini paylaşır.
  • Nuxt.js, paylaşılan bağımlılıkları çapraz kaynak depolama alanından yükler ve bir Vite COS eklentisi bulundurur.
  • Prompt API Polyfill, yapay zeka modellerini WebLLM ve Transformers.js arka uçlarında paylaşır.
  • Prebid.js, başlıktan teklif alma (header bidding) kitaplığının COS'a hazır bir CDN dağıtımına sahiptir.

Standartlaştırma

Çapraz Kaynak Depolama, erken aşamadaki bir WICG teklifidir. Erken W3C TAG Tasarım İncelemesi'ni okuyabilirsiniz.

Kaynaklar ve geri bildirim

API ve teklifle ilgili geri bildirimlerinizi bekliyoruz.

Ayrıca şu araçlara ve demolara göz atın:

Ek okuma materyali

Söyleşiler ve podcast'ler