chrome.management

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

chrome.management API มีวิธีจัดการแอปและส่วนขยายที่ติดตั้งไว้

สิทธิ์

management

ไฟล์ Manifest

คุณต้องประกาศสิทธิ์ "management" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ Management API เช่น

{
  "name": "My extension",
  ...
  "permissions": [
    "management"
  ],
  ...
}

management.getPermissionWarningsByManifest, management.uninstallSelf และ management.getSelf ไม่จำเป็นต้องมีสิทธิ์การจัดการ

ประเภท

ExtensionDisabledReason

Chrome 44 ขึ้นไป

สาเหตุที่ปิดใช้รายการ

ค่าแจกแจง

"unknown"

"permissions_increase"

ExtensionInfo

ข้อมูลเกี่ยวกับส่วนขยาย แอป หรือธีมที่ติดตั้ง

พร็อพเพอร์ตี้

• appLaunchUrl

  สตริง ไม่บังคับ

  URL การเปิดใช้งาน (แสดงเฉพาะแอปเท่านั้น)

• availableLaunchTypes

  LaunchType[] ไม่บังคับ

  ประเภทการเปิดตัวที่พร้อมใช้งานในปัจจุบัน (แสดงเฉพาะแอปเท่านั้น)

• คำอธิบาย

  สตริง

  คำอธิบายของส่วนขยาย แอป หรือธีมนี้

• disabledReason

  ExtensionDisabledReason ไม่บังคับ

  สาเหตุที่ปิดใช้รายการ

• เปิดอยู่

  บูลีน

  เปิดหรือปิดใช้อยู่ในปัจจุบัน

• homepageUrl

  สตริง ไม่บังคับ

  URL ของหน้าแรกของส่วนขยาย แอป หรือธีมนี้

• hostPermissions

  string[]

  แสดงรายการสิทธิ์ตามโฮสต์

• ไอคอน

  IconInfo[] ไม่บังคับ

  รายการข้อมูลไอคอน โปรดทราบว่านี่เป็นเพียงการแสดงสิ่งที่ประกาศไว้ในไฟล์ Manifest และรูปภาพจริงที่ URL นั้นอาจใหญ่หรือเล็กกว่าที่ประกาศไว้ คุณจึงอาจพิจารณาใช้แอตทริบิวต์ความกว้างและความสูงที่ชัดเจนในแท็ก img ที่อ้างอิงรูปภาพเหล่านี้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับไฟล์ Manifest ของไอคอน

• id

  สตริง

  ตัวระบุที่ไม่ซ้ำกันของส่วนขยาย

• installType

  ExtensionInstallType

  วิธีติดตั้งส่วนขยาย

• isApp

  บูลีน

  เลิกใช้งานแล้ว

  โปรดใช้ management.ExtensionInfo.type

  เป็นจริงหากเป็นแอป

• launchType

  LaunchType ไม่บังคับ

  ประเภทการเปิดแอป (แสดงเฉพาะแอปเท่านั้น)

• mayDisable

  บูลีน

  ผู้ใช้จะปิดใช้หรือถอนการติดตั้งส่วนขยายนี้ได้หรือไม่

• mayEnable

  บูลีน ไม่บังคับ

  Chrome 62 ขึ้นไป

  ผู้ใช้เปิดใช้ส่วนขยายนี้ได้หรือไม่ ระบบจะแสดงผลเฉพาะส่วนขยายที่ไม่ได้เปิดใช้เท่านั้น

• name

  สตริง

  ชื่อของส่วนขยาย แอป หรือธีมนี้

• offlineEnabled

  บูลีน

  ระบุว่าส่วนขยาย แอป หรือธีมประกาศว่ารองรับการใช้งานแบบออฟไลน์หรือไม่

• optionsUrl

  สตริง

  URL ของหน้าตัวเลือกของรายการ (หากมี)

• สิทธิ์

  string[]

  แสดงรายการสิทธิ์ตาม API

• shortName

  สตริง

  ชื่อเวอร์ชันย่อของส่วนขยาย แอป หรือธีมนี้

• ประเภท

  ExtensionType

  ประเภทของส่วนขยาย แอป หรือธีมนี้

• updateUrl

  สตริง ไม่บังคับ

  URL อัปเดตของส่วนขยาย แอป หรือธีมนี้

• เวอร์ชัน

  สตริง

  เวอร์ชันของส่วนขยาย แอป หรือธีมนี้

• versionName

  สตริง ไม่บังคับ

  Chrome 50 ขึ้นไป

  ชื่อเวอร์ชันของส่วนขยาย แอป หรือธีมนี้ หากไฟล์ Manifest ระบุไว้

ExtensionInstallType

Chrome 44 ขึ้นไป

วิธีติดตั้งส่วนขยาย ค่าใดค่าหนึ่งต่อไปนี้ admin: ติดตั้งส่วนขยายเนื่องจากนโยบายการดูแลระบบ development: โหลดส่วนขยายแบบไม่แพ็กในโหมดนักพัฒนาซอฟต์แวร์ normal: ติดตั้งส่วนขยายตามปกติผ่านไฟล์ .crx sideload: ติดตั้งส่วนขยายโดยซอฟต์แวร์อื่นในเครื่อง other: ติดตั้งส่วนขยายด้วยวิธีอื่น

ค่าแจกแจง

"admin"

"การพัฒนา"

"normal"

"ไซด์โหลด"

"other"

ExtensionType

Chrome 44 ขึ้นไป

ประเภทของส่วนขยาย แอป หรือธีมนี้

ค่าแจกแจง

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

ข้อมูลเกี่ยวกับไอคอนที่เป็นของส่วนขยาย แอป หรือธีม

พร็อพเพอร์ตี้

• ขนาด

  ตัวเลข

  ตัวเลขที่แสดงความกว้างและความสูงของไอคอน ค่าที่เป็นไปได้รวมถึง (แต่ไม่จำกัดเพียง) 128, 48, 24 และ 16

• URL

  สตริง

  URL ของรูปภาพไอคอนนี้ หากต้องการแสดงไอคอนเวอร์ชันโทนสีเทา (เพื่อระบุว่าส่วนขยายปิดใช้อยู่ เป็นต้น) ให้เพิ่ม ?grayscale=true ต่อท้าย URL

LaunchType

ประเภทการเปิดแอปที่เป็นไปได้ทั้งหมดมีดังนี้

ค่าแจกแจง

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 ขึ้นไป

ตัวเลือกสำหรับวิธีจัดการการถอนการติดตั้งส่วนขยาย

พร็อพเพอร์ตี้

• showConfirmDialog

  บูลีน ไม่บังคับ

  กล่องโต้ตอบยืนยันการถอนการติดตั้งควรแจ้งผู้ใช้หรือไม่ ค่าเริ่มต้นคือ "เท็จ" สำหรับการถอนการติดตั้งด้วยตนเอง หากส่วนขยายถอนการติดตั้งส่วนขยายอื่น ระบบจะไม่สนใจพารามิเตอร์นี้และกล่องโต้ตอบจะแสดงเสมอ

เมธอด

createAppShortcut()

Promise

chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

แสดงตัวเลือกเพื่อสร้างทางลัดสำหรับแอป ใน Mac จะสร้างได้เฉพาะทางลัดของแอปที่จัดแพ็กเกจเท่านั้น

พารามิเตอร์

• id

  สตริง

  ซึ่งควรเป็นรหัสจากรายการแอปของ management.ExtensionInfo

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

generateAppForLink()

Promise

chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

สร้างแอปสำหรับ URL แสดงแอปบุ๊กมาร์กที่สร้างขึ้น

พารามิเตอร์

• URL

  สตริง

  URL ของหน้าเว็บ รูปแบบของ URL ต้องเป็น "http" หรือ "https" เท่านั้น

• title

  สตริง

  ชื่อของแอปที่สร้างขึ้น

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (result: ExtensionInfo) => void

  • ผลลัพธ์

    ExtensionInfo

การคืนสินค้า

• Promise<ExtensionInfo>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

get()

Promise

chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

แสดงข้อมูลเกี่ยวกับส่วนขยาย แอป หรือธีมที่ติดตั้งซึ่งมีรหัสที่ระบุ

พารามิเตอร์

• id

  สตริง

  รหัสจากรายการของ management.ExtensionInfo

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (result: ExtensionInfo) => void

  • ผลลัพธ์

    ExtensionInfo

การคืนสินค้า

• Promise<ExtensionInfo>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getAll()

Promise

chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

แสดงรายการข้อมูลเกี่ยวกับส่วนขยายและแอปที่ติดตั้ง

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (result: ExtensionInfo[]) => void

  • ผลลัพธ์

    ExtensionInfo[]

การคืนสินค้า

• Promise<ExtensionInfo[]>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getPermissionWarningsById()

Promise

chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

แสดงรายการคำเตือนเกี่ยวกับสิทธิ์สำหรับรหัสส่วนขยายที่ระบุ

พารามิเตอร์

• id

  สตริง

  รหัสของส่วนขยายที่ติดตั้งไว้แล้ว

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (permissionWarnings: string[]) => void

  • permissionWarnings

    string[]

การคืนสินค้า

• Promise<string[]>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getPermissionWarningsByManifest()

Promise

chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

แสดงรายการคำเตือนเกี่ยวกับสิทธิ์สำหรับสตริงไฟล์ Manifest ของส่วนขยายที่ระบุ หมายเหตุ: ฟังก์ชันนี้ใช้ได้โดยไม่ต้องขอสิทธิ์ "management" ในไฟล์ Manifest

พารามิเตอร์

• manifestStr

  สตริง

  สตริง JSON ของไฟล์ Manifest ของส่วนขยาย

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (permissionWarnings: string[]) => void

  • permissionWarnings

    string[]

การคืนสินค้า

• Promise<string[]>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getSelf()

Promise

chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

แสดงข้อมูลเกี่ยวกับส่วนขยาย แอป หรือธีมที่เรียกใช้ หมายเหตุ: ฟังก์ชันนี้ใช้ได้โดยไม่ต้องขอสิทธิ์ "management" ในไฟล์ Manifest

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (result: ExtensionInfo) => void

  • ผลลัพธ์

    ExtensionInfo

การคืนสินค้า

• Promise<ExtensionInfo>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

installReplacementWebApp()

Promise Chrome 77 ขึ้นไป

chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

เปิด replacement_web_app ที่ระบุไว้ในไฟล์ Manifest แจ้งให้ผู้ใช้ติดตั้งหากยังไม่ได้ติดตั้ง

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

launchApp()

Promise

chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

เปิดแอปพลิเคชัน

พารามิเตอร์

• id

  สตริง

  รหัสส่วนขยายของแอปพลิเคชัน

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

setEnabled()

Promise

chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

เปิดหรือปิดใช้แอปหรือส่วนขยาย ในกรณีส่วนใหญ่ ฟังก์ชันนี้ต้องเรียกใช้ในบริบทของท่าทางผู้ใช้ (เช่น ตัวแฮนเดิล onclick สำหรับปุ่ม) และอาจแสดง UI การยืนยันแบบเนทีฟแก่ผู้ใช้เพื่อป้องกันการละเมิด

พารามิเตอร์

• id

  สตริง

  ซึ่งควรเป็นรหัสจากรายการของ management.ExtensionInfo

• เปิดอยู่

  บูลีน

  ควรเปิดหรือปิดใช้รายการนี้

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

setLaunchType()

Promise

chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

ตั้งค่าประเภทการเปิดแอป

พารามิเตอร์

• id

  สตริง

  ซึ่งควรเป็นรหัสจากรายการแอปของ management.ExtensionInfo

• launchType

  LaunchType

  ประเภทการเปิดตัวเป้าหมาย ตรวจสอบและตรวจสอบว่าประเภทการเปิดตัวนี้อยู่ใน ExtensionInfo.availableLaunchTypes เสมอ เนื่องจากประเภทการเปิดตัวที่ใช้ได้จะแตกต่างกันไปตามแพลตฟอร์มและการกำหนดค่าต่างๆ

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

uninstall()

Promise

chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

ถอนการติดตั้งแอปหรือส่วนขยายที่ติดตั้งอยู่ในปัจจุบัน หมายเหตุ: ฟังก์ชันนี้จะใช้ไม่ได้ในสภาพแวดล้อมที่มีการจัดการเมื่อผู้ใช้ไม่ได้รับอนุญาตให้ถอนการติดตั้งส่วนขยาย/แอปที่ระบุ หากถอนการติดตั้งไม่สำเร็จ (เช่น ผู้ใช้ยกเลิกกล่องโต้ตอบ) ระบบจะปฏิเสธสัญญาหรือเรียกใช้ Callback โดยตั้งค่า runtime.lastError ไว้

พารามิเตอร์

• id

  สตริง

  ซึ่งควรเป็นรหัสจากรายการของ management.ExtensionInfo

• ตัวเลือก

  UninstallOptions ไม่บังคับ

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

uninstallSelf()

Promise

chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

ถอนการติดตั้งส่วนขยายการโทร หมายเหตุ: ฟังก์ชันนี้ใช้ได้โดยไม่ต้องขอสิทธิ์ "management" ในไฟล์ Manifest ฟังก์ชันนี้จะไม่ทำงานในสภาพแวดล้อมที่มีการจัดการเมื่อผู้ใช้ไม่ได้รับอนุญาตให้ถอนการติดตั้งส่วนขยาย/แอปที่ระบุ

พารามิเตอร์

• ตัวเลือก

  UninstallOptions ไม่บังคับ

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 88 ขึ้นไป

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

กิจกรรม

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

เริ่มทำงานเมื่อปิดใช้แอปหรือส่วนขยาย

พารามิเตอร์

• callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (info: ExtensionInfo) => void

  • ข้อมูล

    ExtensionInfo

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

เริ่มทำงานเมื่อเปิดใช้แอปหรือส่วนขยาย

พารามิเตอร์

• callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (info: ExtensionInfo) => void

  • ข้อมูล

    ExtensionInfo

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

เริ่มทำงานเมื่อมีการติดตั้งแอปหรือส่วนขยาย

พารามิเตอร์

• callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (info: ExtensionInfo) => void

  • ข้อมูล

    ExtensionInfo

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

เริ่มทำงานเมื่อมีการถอนการติดตั้งแอปหรือส่วนขยาย

พารามิเตอร์

• callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (id: string) => void

  • id

    สตริง