chrome.loginState

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.loginState لقراءة حالة تسجيل الدخول ومراقبتها.

الأذونات

loginState

مدى التوفّر

الإصدار 78 من Chrome أو إصدار أحدث نظام التشغيل ChromeOS فقط

الأنواع

ProfileType

تعداد

‫"SIGNIN_PROFILE"
تحدّد هذه السمة أنّ الإضافة متوفّرة في ملف تسجيل الدخول.

‫"USER_PROFILE"
تحدّد هذه السمة أنّ الإضافة متوفّرة في الملف الشخصي للمستخدم.

‫"LOCK_PROFILE"
تحدّد هذه السمة أنّ الإضافة متوفّرة في ملف شاشة القفل.

SessionState

تعداد

‫"UNKNOWN"
تحدّد هذه الحالة أنّ حالة الجلسة غير معروفة.

‫"IN_OOBE_SCREEN"
تحدّد هذه السمة أنّ المستخدم في شاشة تجربة الاستخدام الجاهز.

‫"IN_LOGIN_SCREEN"
تحدّد هذه القيمة أنّ المستخدم في شاشة تسجيل الدخول.

‫"IN_SESSION"
تحدّد هذه السمة أنّ المستخدم في الجلسة.

‫"IN_LOCK_SCREEN"
تحدّد هذه السمة أنّ المستخدم في شاشة القفل.

‫"IN_RMA_SCREEN"
يشير إلى أنّ الجهاز في وضع RMA، ويتم الانتهاء من عمليات الإصلاح.

الطُرق

getProfileType()

وعد 
chrome.loginState.getProfileType(
  callback?: function,
): Promise<ProfileType>

تعرض هذه السمة نوع الملف الشخصي الذي تتضمّنه الإضافة.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: ProfileType) => void

المرتجعات

  • Promise<ProfileType>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getSessionState()

وعد 
chrome.loginState.getSessionState(
  callback?: function,
): Promise<SessionState>

تعرض هذه السمة حالة الجلسة الحالية.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: SessionState) => void

المرتجعات

  • Promise<SessionState>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

الفعاليات

onSessionStateChanged

chrome.loginState.onSessionStateChanged.addListener(
  callback: function,
)

يتم إرسال هذا الحدث عند تغيُّر حالة الجلسة. ‫sessionState هي حالة الجلسة الجديدة.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (sessionState: SessionState) => void