chrome.app.runtime

תיאור

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

סוגים

ActionData

Chrome 54+

מאפיינים

  • actionType

    "new_note"

ActionType

Chrome 54+

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

ערך

"new_note"

EmbedRequest

מאפיינים

  • נתונים

    כל אופציונלי

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

  • embedderId

    מחרוזת

  • לאפשר

    ריק

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

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

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

    • כתובת אתר

      מחרוזת

  • דחייה

    ריק

    האפליקציה 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"

&quot;app_launcher&quot;

"new_tab_page"

"טעינה מחדש"

"restart"

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

"url_handler"

"system_tray"

"about_page"

"מקלדת"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

"רקע"

"קיוסק"

"chrome_internal"

"test"

&quot;installed_notification&quot;

&quot;context_menu&quot;

"arc"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;

"Sparky"

אירועים

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