chrome.app.runtime

תיאור

משתמשים ב-API chrome.app.runtime כדי לנהל את מחזור החיים של האפליקציה. סביבת זמן הריצה של האפליקציה מנהלת את התקנת האפליקציה, שולטת בדף האירוע ויכולה לכבות את האפליקציה בכל שלב.

סוגים

ActionData

Chrome 54 ואילך

תכונות

  • actionType

    "new_note"

ActionType

Chrome 54 ואילך

ניתן להפעיל אפליקציה מסוימת מתוך מחשבה על פעולה ספציפית, לדוגמה, יצירת הערה חדשה. סוג הפעולה שאיתה האפליקציה הופעלה זמין בתוך השדה actionData במופע של LaunchData.

ערך

"new_note"

EmbedRequest

תכונות

  • נתונים

    כל אופציונלי

    נתונים אופציונליים שצוינו על ידי המפתח, שבהם האפליקציה להטמעה יכולה להשתמש כדי לקבל החלטה בנוגע להטמעה.

  • embedderId

    string

  • לאפשר

    void

    מאפשרת ל-embedderId להטמיע את האפליקציה הזו ברכיב <appview>. השדה url מציין את התוכן להטמעה.

    הפונקציה allow נראית כך: 

    (url: string) => {...}

    • כתובת אתר

      string

  • דחייה

    void

    embedderId לא יוכל להטמיע את האפליקציה הזו ברכיב <appview>.

    הפונקציה deny נראית כך: 

    () => {...}

LaunchData

תכונות

  • actionData

    ActionData אופציונלי

    Chrome 54 ואילך

    מכילה נתונים שמציינים את הActionType שאיתם האפליקציה הושקה. הערך הזה הוא null אם האפליקציה לא הושקה עם כוונה ספציפית לפעולה.

  • id

    מחרוזת אופציונלי

    המזהה של הקובץ או ה-handler של כתובת ה-URL שאיתו האפליקציה מופעלת. מזהי handler הם המפתחות ברמה העליונה במילונים file_handlers או url_handlers במניפסט.

  • isKioskSession

    ערך בוליאני אופציונלי

    האם האפליקציה מופעלת בסשן קיוסק של Chrome OS.

  • isPublicSession

    ערך בוליאני אופציונלי

    Chrome מגרסה 47 ואילך

    האם האפליקציה מופעלת בסשן ציבורי של Chrome OS.

  • פריטים

    LaunchItem[] אופציונלי (אופציונלי)

    רשומות הקובץ של האירוע onLaunched שהופעלו על ידי handler תואם של קבצים במפתח המניפסט file_handlers.

  • referrerUrl

    מחרוזת אופציונלי

    כתובת ה-URL של הגורם המפנה לאירוע onLaunched, שהופעלה על ידי handler תואם של כתובת URL במפתח המניפסט url_handlers.

  • source

    LaunchSource אופציונלי

    המקום שבו האפליקציה מופעלת.

  • כתובת אתר

    מחרוזת אופציונלי

    כתובת ה-URL של האירוע onLaunched שהופעל על ידי handler תואם של כתובת URL במפתח המניפסט url_handlers.

LaunchItem

תכונות

  • ערך

    הערך

    רשומה עבור הפריט.

  • סוג

    מחרוזת אופציונלי

    סוג ה-MIME של הקובץ.

LaunchSource

ספירת מקורות של הפעלות של אפליקציות. צריך לסנכרן את הנתונים האלה עם AppLaunchSource ברכיבים/services/app_service/public/mojom/types.mojom, ועם GetLaunchSourceEnum() בתוספים/browser/api/app_runtime/app_runtime_api.cc. שימו לב שהספירה משמשת בהיסטוגרמה של UMA, ולכן אין לסדר מחדש או להסיר רשומות.

טיפוסים בני מנייה (enum)

"untracked"

"new_tab_page"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"chrome_internal"

"test"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

אירועים

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

האירוע הזה מופעל כשאפליקציה מטמיעה מבקשת להטמיע את האפליקציה הזו. האירוע הזה זמין רק בערוץ פיתוח עם הדגל --enable-app-view.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (request: EmbedRequest) => void

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

מופעל כשאפליקציה מופעלת ממרכז האפליקציות.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (launchData?: LaunchData) => void

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

הופעלו במהלך ההפעלה של Chrome לאפליקציות שרצו בפעם האחרונה ש-Chrome נסגר, או כשנשלחה בקשה להפעלה מחדש של אפליקציות מהמצב הקודם שלהן מסיבות אחרות (למשל, אם המשתמש מבטל את הגישה לקבצים שנשמרו באפליקציה, בזמן הריצה האפליקציה תופעל מחדש). במצבים האלה, אם לאפליקציות אין handler של onRestarted, הם יקבלו אירוע onLaunched במקום זאת.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    () => void