Gỡ lỗi bộ nhớ dùng chung

Các công cụ để gỡ lỗi liên quan đến Shared Storage.

Gỡ lỗi worklet Bộ nhớ dùng chung bằng Công cụ cho nhà phát triển

Để kiểm tra các worklet Bộ nhớ dùng chung bắt đầu từ trang bạn đang truy cập, bạn có thể truy cập vào thẻ "Nguồn" trong bảng điều khiển Công cụ cho nhà phát triển và thêm điểm ngắt trình nghe sự kiện "Câu lệnh đầu tiên của tập lệnh / worklet Bộ nhớ dùng chung". Điểm ngắt này sẽ tạm dừng quá trình thực thi tập lệnh mô-đun ban đầu hoặc các worklet tồn tại trong thời gian ngắn khi khởi động.

Gỡ lỗi một worklet Shared Storage bằng cách thêm trình nghe ở cấp sự kiện.
Bạn có thể thêm điểm ngắt vào một worklet Bộ nhớ dùng chung.

Ngoài ra, trang chrome://inspect/#shared-storage-worklets cho thấy tất cả các worklet Bộ nhớ dùng chung đang hoạt động trên tất cả các trang.

Gỡ lỗi Bộ nhớ dùng chung và Tổng hợp riêng tư

Để bật tính năng gỡ lỗi, hãy gọi phương thức JavaScript enableDebugMode() trong cùng một ngữ cảnh nơi Shared Storage và Private Aggregation được sử dụng. Điều này sẽ được áp dụng cho các báo cáo trong tương lai trong cùng bối cảnh.

privateAggregation.enableDebugMode();

Để liên kết các báo cáo với những bối cảnh đã kích hoạt các báo cáo đó, bạn có thể đặt một khoá gỡ lỗi là số nguyên không dấu 64 bit được truyền đến lệnh gọi JavaScript. debugKey là một BigInt.

privateAggregation.enableDebugMode({debugKey: 1234});

Gỡ lỗi Bộ nhớ dùng chung

Bộ nhớ dùng chung trả về một thông báo lỗi chung:

Promise is rejected without and explicit error message

Bạn có thể gỡ lỗi Bộ nhớ dùng chung bằng cách bao bọc các lệnh gọi bằng các khối try-catch.

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

Gỡ lỗi tính năng Tổng hợp riêng tư

Báo cáo được gửi đến /.well-known/private-aggregation/report-shared-storage và /.well-known/private-aggregation/debug/report-shared-storage. Báo cáo gỡ lỗi nhận được một tải trọng tương tự như JSON sau. Tải trọng này xác định trường api là "shared-storage".

{
   "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\"}"
}

Gỡ lỗi tải trọng văn bản thô

debug_cleartext_payload được mã hoá Base64 CBOR. Bạn có thể xem nhóm và giá trị bằng trình giải mã hoặc sử dụng mã JavaScript có trong trình giải mã Bộ nhớ dùng chung.

Tương tác và chia sẻ ý kiến phản hồi

Xin lưu ý rằng đề xuất về Shared Storage API đang được thảo luận và phát triển tích cực, vì vậy, đề xuất này có thể thay đổi.

Chúng tôi rất mong được biết ý kiến của bạn về Shared Storage API.