Paylaşılan Depolama Alanını Hata Ayıklama

Shared Storage ile ilgili sorunları ayıklamaya yönelik araçlar.

Geliştirici Araçları ile Shared Storage iş akışlarında hata ayıklama

Bulunduğunuz sayfadan başlatılan Shared Storage worklet'lerini incelemek için DevTools panelindeki "Kaynaklar" sekmesini ziyaret edebilir ve "Shared Storage Worklet / Script First Statement" etkinlik işleyici kesme noktasını ekleyebilirsiniz. Bu kesme noktası, başlangıçta ilk modül komut dosyası yürütülmesini veya kısa ömürlü iş parçacıklarını duraklatır.

Etkinlik düzeyinde işleyici ekleyerek Shared Storage iş akışında hata ayıklama.
Ortak Depolama iş akışına ayırma noktası eklenebilir.

Ayrıca, chrome://inspect/#shared-storage-worklets sayfasında tüm sayfalardaki etkin tüm paylaşılan depolama alanı işlevleri gösterilir.

Ortak Depolama ve Özel Toplama Hata Ayıklama

Hata ayıklamayı etkinleştirmek için enableDebugMode() JavaScript yöntemini, Shared Storage ve Private Aggregation'ın kullanıldığı bağlamda çağırın. Bu, aynı bağlamdaki gelecekteki raporlar için geçerli olacaktır.

privateAggregation.enableDebugMode();

Raporları tetikleyen bağlamlarla ilişkilendirmek için JavaScript çağrısına iletilen 64 bitlik işaretsiz bir tamsayı hata ayıklama anahtarı ayarlayabilirsiniz. debugKey, BigInt.

privateAggregation.enableDebugMode({debugKey: 1234});

Shared Storage'da hata ayıklama

Shared Storage, genel bir hata mesajı döndürüyor:

Promise is rejected without and explicit error message

Çağrıları try-catch bloklarıyla sarmalayarak Shared Storage'da hata ayıklama yapabilirsiniz.

try {
  privateAggregation.contributeToHistogram({bucket, value});
} catch (e){
  console.log(e);
}

Private Aggregation'da hata ayıklama

Raporlar /.well-known/private-aggregation/report-shared-storage ve /.well-known/private-aggregation/debug/report-shared-storage adreslerine gönderilir. Hata ayıklama raporları, aşağıdaki JSON'a benzer bir yük alır. Bu yük, api alanını "shared-storage" olarak tanımlar.

{
   "aggregation_coordinator_origin": "https://publickeyservice.msmt.gcp.privacysandboxservices.com",
   "aggregation_service_payloads": [ {
      "debug_cleartext_payload": "omRkYXRhlKJldmFsdWVEAAAAgGZidWNrZXRQAAAAAAAAAAAAAAAAB1vNFaJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAKJldmFsdWVEAAAAAGZidWNrZXRQAAAAAAAAAAAAAAAAAAAAAGlvcGVyYXRpb25paGlzdG9ncmFt",
      "key_id": "1569ab37-da44-4a26-80d9-5ed6524ab2a7",
      "payload": "/9nHrWn1MnJWRxFvanbubciWE9mPyIij6uYLi5k351eQCd3/TZpe2knaatUNcniq4a4e61tmKebv50OmMRZFnnCfcAwIdIgLHu1a3en97PojqWJBfO52RiVMIcP7KQTLzMxq2LhvPSdV4zjXo1Teu/JuIK3LIyis3vUMpS+tUAX0QV+I6X5SVmZFiNW9aMb8DwLOtqrBy5JJ/EkOIY0G+1Fi1/3R7UtKsqM1o71A/OzdmlNkwO7EV/VUNinGvWnd19FvDHe/kqkNdTHKbhAnMmbZzHW9bsEQS81leElCla6BTdbdbeeFU/jbTj0AOaoNOIe5r7FU5NG6nW4ULXTCbLLjTQ1mtl3id3IP41Zin1JvABCDC/HUSgLFz8EUqkmbMIOlMfNYA79aURq6FqE0GO0HtICYf0GPNdVv7p4jY3FNn6+JS4l5F3t+3lP9ceo4IpCE+31jzMtYJ+19xFh6C5ufteBR/iknZFcc1w3caQBhgRl5jt8DbaOzYcW4690H8Ul4Oh2wRO+6/njifk+pExLay/O5swLi2lUUph5OUEaaztwwzh2mnhwIBxMkPnfsGihiF+5KDEajVfMZ3NLsIDoZO+l4RTZrkqE+jVkAqaZGBiCIx42Edp/JV0DXfrryypCdQBZr8iEbSzCM9hKsMfLN7S/VkPe5rDwOZbhKCn5XXgfGz5tSx/KbZgsQf4OCEhwAyNPHAh3MHU7xmkQ3pKg4EIUC/WOtKAlVDOtDMmPPoQY1eAwJhw9SxZaYF1kHjUkTm3EnGhgXgOwCRWqeboNenSFaCyp6DbFNI3+ImONMi2oswrrZO+54Tyhca5mnLIiInI+C3SlP4Sv1jFECIUdf/mifJRM5hMj6OChzHf4sEifjqtD4A30c4OzGexWarie2xakdQej9Go4Lm0GZEDBfcAdWLT9HwmpeI2u4HDAblXDvLN8jYFDOOtzOl90oU7AwdhkumUCFLRadXAccXW9SvLfDswRkXMffMJLFqkRKVE1GPonFFtlzaRqp7IgE8L6AOtz6NDcxAjHnEuzDPPMcWMl1AFH0gq7h"
   } ],
   "debug_key": "1234",
   "shared_info": "{\"api\":\"shared-storage\",\"debug_mode\":\"enabled\",\"report_id\":\"80d93c0a-a94e-4ab7-aeb5-a4ecd4bfc598\",\"reporting_origin\":\"https://privacy-sandbox-demos-dsp.dev\",\"scheduled_report_time\":\"1717784740\",\"version\":\"0.1\"}"
}

Şifresiz metin yükünde hata ayıklama

debug_cleartext_payload, Base64 CBOR kodludur. Paketi ve değeri kod çözücüyü kullanarak görüntüleyebilir veya Shared Storage kod çözücüsünde bulunan JavaScript kodunu kullanabilirsiniz.

Etkileşim kurma ve geri bildirim paylaşma

Shared Storage API teklifinin aktif olarak tartışılıp geliştirildiğini ve bu nedenle değişebileceğini unutmayın.

Shared Storage API hakkındaki düşüncelerinizi öğrenmek istiyoruz.