chrome.loginState

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

loginState

مدى التوفّر

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

الأنواع

ProfileType

Enum

‫"SIGNIN_PROFILE"
تشير إلى أنّ الإضافة في الملف الشخصي لتسجيل الدخول.

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

‫"LOCK_PROFILE"
تشير إلى أنّ الإضافة في الملف الشخصي لشاشة القفل.

SessionState

Enum

"UNKNOWN"
تشير إلى أنّ حالة الجلسة غير معروفة.

"IN_OOBE_SCREEN"
تحدّد أنّ المستخدم في شاشة انطباع التجربة الأولى.

"IN_LOGIN_SCREEN"
تشير إلى أنّ المستخدم في شاشة تسجيل الدخول.

"IN_SESSION"
تشير إلى أنّ المستخدم في الجلسة.

‫"IN_LOCK_SCREEN"
تشير إلى أنّ المستخدم في شاشة القفل.

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

الطُرق

getProfileType()

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

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

المعلمات

  • callback

    function اختياري

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

    (result: ProfileType) => void

المرتجعات

  • Promise<ProfileType>

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

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

getSessionState()

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

تتيح هذه الطريقة الحصول على حالة الجلسة الحالية.

المعلمات

  • callback

    function اختياري

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

    (result: SessionState) => void

المرتجعات

  • Promise<SessionState>

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

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

الفعاليات

onSessionStateChanged

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

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

المعلمات

  • callback

    دالة

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

    (sessionState: SessionState) => void