واجهة برمجة تطبيقات الوصول إلى التخزين
لماذا هذا مهم حظر ملفات تعريف الارتباط الخاصة بأطراف ثالثة أو تقسيمها يوقف أدوات التتبع، لكنه يؤدي أيضاً إلى تسجيل خروجك من العناصر المضمنة الصادقة: صندوق تعليقات تكون مسجلاً فيه، مشغل فيديو يعرف حسابك، أو نموذج تسجيل دخول داخل صفحة أخرى. واجهة برمجة تطبيقات Storage Access API هي الطريقة التي تسمح بها المتصفحات لتلك العناصر المضمنة بالعمل مرة أخرى، مع بقائك أنت في وضع التحكم.
فكر في غرفة الملابس مرة أخرى. كل متجر لديه الآن دفتر تذاكر خاص به، لذا فإن تذكرة غرفة الملابس الرئيسية الخاصة بك من مبنى AdCo تصبح عديمة الفائدة داخل ShopA. واجهة برمجة تطبيقات Storage Access هي موظف غرفة الملابس في ShopA الذي يسألك: "هل تود استخدام تذكرتك الرئيسية هنا؟" إذا قلت نعم، يمكن لذلك الموظف الواحد، في ذلك المتجر الواحد، استخدامها.
واجهة الوصول إلى التخزين API: ميزة في المتصفح تسمح لإطار مدمج من موقع آخر بطلب الوصول إلى ملفات تعريف الارتباط unpartitioned الخاصة به، وهي الملفات التي يمتلكها عند زيارته مباشرة.
إيماءة المستخدم: فعل حقيقي منك، مثل نقرة أو ضغطة مفتاح، داخل الصفحة. تستخدمها المتصفحات كدليل على أن الطلب لم يتم بصمت بواسطة script.
كيف يطلب الـ embed
تخيل أن comments.example مدمج في blog.example. داخل إطاره، يقوم النص البرمجي الخاص به بهذا (JavaScript، معروض للقراءة فقط):
// Inside the comments.example frame
if (!(await document.hasStorageAccess())) {
signInButton.onclick = async () => { // must run inside a click
try {
await document.requestStorageAccess(); // the browser may ask you
location.reload(); // now it sees its own cookies
} catch {
showMessage("Open comments.example to sign in");
}
};
}
يجيب hasStorageAccess() على سؤال "هل لدي ملفات تعريف الارتباط هنا بالفعل؟" يطلب requestStorageAccess() الحصول عليها، وينجح أو يفشل. يتعامل embed مكتوب بشكل جيد مع الفشل بسلاسة.
تطبق محركات القواعد
- تطلب الإطارات المضمنة فقط. الصفحة ذات المستوى الأعلى لديها ملفات تعريف ارتباط خاصة بها بالفعل.
- A user gesture is required. A script cannot request access silently on page load; it must be inside your click.
- قد يتعين عليك معرفة الـ embed. يمكن لمحركات البحث أن تتطلب زيارتك للموقع المدمج مباشرة من قبل، لذا لا يمكن لمتتبع لم تسمع به من قبل أن يطلب ذلك. متصفح Safari، على سبيل المثال، يتطلب هذا.
- قد يظهر المتصفح رسالة تنبيه، تذكر كلا الموقعين، ويمكنك الرفض.
- التراخيص محدودة. وهي تغطي موقعا مضمنا واحدا في موقع واحد من المستوى الأعلى، وتنتهي صلاحيتها بعد فترة.
- Sandboxed frames تحتاج إلى أن تسمح الصفحة بذلك صراحة، مع
allow-storage-access-by-user-activationsandbox token.
تختلف الأوامر الدقيقة والقيود الزمنية بين المحركات وتتغير بمرور الوقت؛ الشكل أعلاه مشترك بينها جميعا.
أين يتم الشحن
توفر واجهة برمجة تطبيقات Storage Access في متصفحات Safari وFirefox وChrome (في Chrome منذ الإصدار 119). في Chrome، يهم هذا الأمر فقط للمستخدمين الذين يحظرون ملفات تعريف الارتباط الخاصة بالطرف الثالث، لأن الجميع الآخر لا يزال لديهم ملفات تعريف ارتباط غير مقسمة للطرف الثالث. تم إيقاف مجموعات المواقع ذات الصلة، التي كانت تمنح الوصول تلقائيا بين المواقع المملوكة لشركة واحدة (تم التحقق في أكتوبر 2026).
الوصول إلىStorage مقابل CHIPS
من السهل الخلط بينهما. باستخدام CHIPS (سمة Partitioned من Leg 1)، يقبل الـ embed ملف jar منفصل على كل موقع ولا يحتاج إلى إذن. أما مع Storage Access، يطلب الـ embed ملف jar المشترك one الخاص به، والذي يمكنه التعرف عليك عبر المواقع، لذا فإنه يحتاج إلى إيماءة منك وربما موافقتك. يفضل استخدام CHIPS عندما لا يحتاج الـ embed لمعرفة هويتك في مكان آخر.
A مفهوم خاطئ شائع
"منح الوصول إلى التخزين يسمح لـ embed بقراءة ملفات تعريف الارتباط الخاصة بالصفحة." هذا غير صحيح. comments.example يحصل على ملفات تعريف الارتباط الخاصة به فقط، ولا يحصل على أي شيء من blog.example. ما توافق عليه هو أن comments.example قد يتعرف عليك في هذه المدونة.
ملخص
- تسمح واجهة برمجة تطبيقات Storage Access بطلب ملفات تعريف الارتباط غير المقسمة الخاصة بها من قبل العنصر المضمن.
- يتطلب إيماءة مستخدم، ويعمل فقط في الإطارات، وقد يطلب منك، ويمنح تضمينا واحدا على موقع واحد لفترة محدودة.
- يعمل في Safari و Firefox و Chrome 119؛ في Chrome يهم الأمر فقط عندما يتم حظر ملفات تعريف الارتباط للطرف الثالث (تم التحقق في أكتوبر 2026). يوفر
- CHIPS ملف jar منفصلاً لكل موقع بدون إذن؛ بينما يمنح Storage Access ملف jar المشترك بموافقتك.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.