سرویس حافظه پنهان (Cache Service) به شما امکان میدهد برای ذخیره کوتاهمدت دادهها به حافظه پنهان (cache) دسترسی داشته باشید.
این کلاس به شما امکان میدهد یک نمونه کش خاص را دریافت کنید. کشهای عمومی برای مواردی هستند که به کاربری که به اسکریپت شما دسترسی دارد وابسته نیستند. کشهای خصوصی برای مواردی هستند که مختص کاربر هستند، مانند تنظیمات یا فعالیتهای اخیر.
تضمینی وجود ندارد که دادههایی که در حافظه پنهان مینویسید تا زمان انقضایشان باقی بمانند. شما باید آماده باشید که از تمام خواندنها، null دریافت کنید.
روشها
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
get Document Cache() | Cache |null | نمونهی کش را که به سند و اسکریپت فعلی محدود شده است، دریافت میکند. |
get Script Cache() | Cache | نمونهی کش را به اسکریپت اختصاص میدهد. |
get User Cache() | Cache | نمونهی کش را که به کاربر و اسکریپت فعلی محدود شده است، دریافت میکند. |
مستندات دقیق
get Document Cache()
نمونه کش را در محدوده سند و اسکریپت فعلی دریافت میکند. کشهای سند مختص سند فعلی هستند که حاوی اسکریپت است. از این کشها برای ذخیره اطلاعات اسکریپتی که مختص سند فعلی است استفاده کنید. اگر این متد خارج از چارچوب یک سند حاوی (مانند یک اسکریپت مستقل یا برنامه وب) فراخوانی شود، این متد null را برمیگرداند.
// Gets a cache that is specific to the current document containing the script const cache = CacheService.getDocumentCache();
بازگشت
Cache |null — یک نمونه از حافظه پنهان سند، یا null اگر هیچ سندی وجود نداشته باشد
get Script Cache()
نمونه کش را به اسکریپت محدود میکند. کشهای اسکریپت برای همه کاربران اسکریپت مشترک هستند. از اینها برای ذخیره اطلاعاتی که مختص کاربر فعلی نیست استفاده کنید.
// Gets a cache that is common to all users of the script const cache = CacheService.getScriptCache();
بازگشت
Cache - یک نمونه حافظه پنهان اسکریپت
get User Cache()
نمونه کش را به کاربر و اسکریپت فعلی محدود میکند. کشهای کاربر مختص کاربر فعلی اسکریپت هستند. از این کشها برای ذخیره اطلاعات اسکریپتی که مختص کاربر فعلی است استفاده کنید.
// Gets a cache that is specific to the current user of the script const cache = CacheService.getUserCache();
بازگشت
Cache - یک نمونه از حافظه پنهان کاربر