chrome.system.display

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API system.display per eseguire query sui metadati visibili.

Autorizzazioni

system.display

Tipi

ActiveState

Chrome 117 e versioni successive

Un enum per indicare se il display viene rilevato e utilizzato dal sistema. Il display è considerato "non attivo" se non viene rilevato dal sistema (ad esempio se è scollegato o considerato scollegato a causa della modalità di sospensione e così via). Questo stato viene utilizzato, ad esempio, per mantenere il display esistente quando tutti i display sono scollegati.

Enum

"active"

"inactive"

Bounds

Proprietà

  • altezza

    numero

    L'altezza del display in pixel.

  • sinistra

    numero

    La coordinata X dell'angolo in alto a sinistra.

  • in alto

    numero

    La coordinata Y dell'angolo in alto a sinistra.

  • larghezza

    numero

    La larghezza del display in pixel.

DisplayLayout

Chrome 53 e versioni successive

Proprietà

  • id

    stringa

    L'identificatore univoco del display.

  • offset

    numero

    L'offset del display lungo il bordo collegato. 0 indica che gli angoli più in alto o più a sinistra sono allineati.

  • parentId

    stringa

    L'identificatore univoco del display principale. Vuoto se si tratta della radice.

  • position

    LayoutPosition

    La posizione del layout di questo display rispetto al display principale. Questo valore verrà ignorato per la radice.

DisplayMode

Chrome 52 e versioni successive

Proprietà

  • deviceScaleFactor

    numero

    Il fattore di scalabilità del dispositivo della modalità di visualizzazione.

  • altezza

    numero

    L'altezza della modalità di visualizzazione in pixel indipendenti dal dispositivo (visibili all'utente).

  • heightInNativePixels

    numero

    L'altezza della modalità di visualizzazione in pixel nativi.

  • isInterlaced

    boolean facoltativo

    Chrome 74 e versioni successive

    True se questa modalità è interlacciata, false se non viene fornita.

  • isNative

    booleano

    True se la modalità è quella nativa del display.

  • isSelected

    booleano

    True se la modalità di visualizzazione è attualmente selezionata.

  • refreshRate

    numero

    Chrome 67 e versioni successive

    La frequenza di aggiornamento della modalità di visualizzazione in hertz.

  • uiScale

    number optional

    Ritirato da Chrome 70

    Utilizza displayZoomFactor

    Il fattore di scalabilità dell'interfaccia utente della modalità di visualizzazione.

  • larghezza

    numero

    La larghezza della modalità di visualizzazione in pixel indipendenti dal dispositivo (visibili all'utente).

  • widthInNativePixels

    numero

    La larghezza della modalità di visualizzazione in pixel nativi.

DisplayProperties

Proprietà

  • boundsOriginX

    number optional

    Se impostato, aggiorna l'origine dei limiti logici del display lungo l'asse X. Applicato insieme a boundsOriginY. Se non è impostato e boundsOriginY è impostato, il valore predefinito è il valore corrente. Tieni presente che quando aggiorni l'origine della visualizzazione, verranno applicati alcuni vincoli, pertanto l'origine dei limiti finali potrebbe essere diversa da quella impostata. I limiti finali possono essere recuperati utilizzando getInfo. L'origine dei limiti non può essere modificata sul display principale.

  • boundsOriginY

    number optional

    Se impostato, aggiorna l'origine dei limiti logici del display lungo l'asse Y. Consulta la documentazione relativa al parametro boundsOriginX.

  • displayMode

    DisplayMode facoltativo

    Chrome 52 e versioni successive

    Se impostato, aggiorna la modalità di visualizzazione in modo che corrisponda a questo valore. Se altri parametri non sono validi, questo non verrà applicato. Se la modalità di visualizzazione non è valida, non verrà applicata e verrà impostato un errore, ma verranno comunque applicate altre proprietà.

  • displayZoomFactor

    number optional

    Chrome 65+

    Se impostato, aggiorna lo zoom associato al display. Questo zoom esegue il ricalcolo del layout e il ridisegno, offrendo uno zoom di qualità migliore rispetto a un semplice ingrandimento pixel per pixel.

  • isPrimary

    boolean facoltativo

    Se impostato su true, il display diventa principale. Nessuna operazione se impostato su false. Nota: se impostato, il display è considerato principale per tutte le altre proprietà (ovvero isUnified potrebbe essere impostato e l'origine dei limiti potrebbe non esserlo).

  • isUnified

    boolean facoltativo

    Chrome 59 e versioni successive

    Solo ChromeOS. Se impostata su true, cambia la modalità di visualizzazione in desktop unificato (per maggiori dettagli, vedi enableUnifiedDesktop). Se viene impostato su false, la modalità desktop unificato verrà disattivata. Questo vale solo per il display principale. Se fornito, mirroringSourceId non deve essere fornito e le altre proprietà verranno ignorate. Se non viene fornito, non ha alcun effetto.

  • mirroringSourceId

    stringa facoltativa

    Ritirato da Chrome 68

    Utilizza setMirrorMode.

    Solo ChromeOS. Se impostato e non vuoto, attiva il mirroring solo per questo display. In caso contrario, il mirroring viene disattivato per tutti i display. Questo valore deve indicare l'ID del display di origine da duplicare, che non deve essere lo stesso dell'ID passato a setDisplayProperties. Se impostata, non è possibile impostare altre proprietà.

  • overscan

    Insets facoltativo

    Se impostato, imposta gli inset di overscan del display sui valori forniti. Tieni presente che i valori di overscan non possono essere negativi o superiori alla metà delle dimensioni dello schermo. L'overscan non può essere modificato sul monitor interno.

  • rotazione

    number optional

    Se impostato, aggiorna la rotazione del display. I valori validi sono [0, 90, 180, 270]. La rotazione è impostata in senso orario, rispetto alla posizione verticale del display.

DisplayUnitInfo

Proprietà

  • activeState

    ActiveState

    Chrome 117 e versioni successive

    Attivo se il display viene rilevato e utilizzato dal sistema.

  • availableDisplayZoomFactors

    number[]

    Chrome 67 e versioni successive

    Un elenco di valori del fattore di zoom che possono essere impostati per il display.

  • bounds

    Limiti

    I limiti logici del display.

  • displayZoomFactor

    numero

    Chrome 65+

    Il rapporto tra lo zoom corrente e quello predefinito del display. Ad esempio, il valore 1 equivale allo zoom al 100% e il valore 1, 5 equivale allo zoom al 150%.

  • dpiX

    numero

    Il numero di pixel per pollice lungo l'asse X.

  • dpiY

    numero

    Il numero di pixel per pollice lungo l'asse y.

  • edid

    Edid facoltativo

    Chrome 67 e versioni successive

    NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS.

  • hasTouchSupport

    booleano

    Chrome 57 e versioni successive

    True se a questo display è associato un dispositivo di input tocco.

  • id

    stringa

    L'identificatore univoco del display.

  • isEnabled

    booleano

    True se questo display è abilitato.

  • isPrimary

    booleano

    True se si tratta del display principale.

  • isUnified

    booleano

    Chrome 59 e versioni successive

    True per tutti i display in modalità desktop unificato. Consulta la documentazione per enableUnifiedDesktop.

  • mirroringDestinationIds

    string[]

    Chrome 64 e versioni successive

    Solo ChromeOS. Identificatori dei display su cui viene eseguito il mirroring del display di origine. Vuoto se non viene eseguito il mirroring di alcun display. Questo valore verrà impostato sullo stesso valore per tutti i display. Non deve includere mirroringSourceId.

  • mirroringSourceId

    stringa

    Solo ChromeOS. Identificatore del display di cui viene eseguito il mirroring se il mirroring è attivo, altrimenti vuoto. Questa impostazione verrà applicata a tutti i display (incluso quello sottoposto a mirroring).

  • modalità

    DisplayMode[]

    Chrome 52 e versioni successive

    L'elenco delle modalità di visualizzazione disponibili. La modalità corrente avrà isSelected=true. Disponibile solo su ChromeOS. Verrà impostato su un array vuoto su altre piattaforme.

  • nome

    stringa

    Il nome facile da usare (ad es. "Monitor LCD HP").

  • overscan

    Riquadri

    Gli inset del display entro i limiti dello schermo. Al momento esposta solo su ChromeOS. Verrà impostato su riquadri vuoti su altre piattaforme.

  • rotazione

    numero

    La rotazione in senso orario del display in gradi rispetto alla posizione verticale. Al momento esposta solo su ChromeOS. Verrà impostato su 0 su altre piattaforme. Un valore pari a -1 verrà interpretato come rotazione automatica quando il dispositivo è in modalità tablet fisica.

  • workArea

    Limiti

    L'area di lavoro utilizzabile del display entro i limiti del display. L'area di lavoro esclude le aree del display riservate al sistema operativo, ad esempio la barra delle app e l'Avvio app.

Edid

Chrome 67 e versioni successive

Proprietà

  • manufacturerId

    stringa

    Codice produttore di 3 caratteri. Consulta la sezione 3.4.1 a pagina 21. Obbligatorio nella versione 1.4.

  • productId

    stringa

    Codice di 2 byte assegnato dal produttore, Sez. 3.4.2, pag. 21. Obbligatorio nella versione 1.4.

  • yearOfManufacture

    numero

    Anno di produzione, sez. 3.4.4, pag. 22. Obbligatorio nella versione 1.4.

GetInfoFlags

Chrome 59 e versioni successive

Proprietà

  • singleUnified

    boolean facoltativo

    Se impostato su true, getInfo restituirà un singolo DisplayUnitInfo quando è attiva la modalità desktop unificato (vedi enableUnifiedDesktop). Il valore predefinito è false.

Insets

Proprietà

  • in basso

    numero

    La distanza dell'asse Y dal limite inferiore.

  • sinistra

    numero

    La distanza dell'asse X dal bordo sinistro.

  • destra

    numero

    La distanza dell'asse X dal bordo destro.

  • in alto

    numero

    La distanza dell'asse Y dal limite superiore.

LayoutPosition

Chrome 53 e versioni successive

Posizione del layout, ovvero il bordo dell'elemento padre a cui è collegato il display.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65+

Modalità Specchio, ovvero diversi modi in cui un display viene duplicato su altri display.

Enum

"off"
Specifica la modalità predefinita (desktop esteso o unificato).

"normal"
Specifica che il display di origine predefinito verrà duplicato su tutti gli altri display.

"mixed"
Specifica che il display di origine specificato verrà duplicato sui display di destinazione forniti. Tutti gli altri display collegati verranno estesi.

MirrorModeInfo

Chrome 65+

Proprietà

  • mirroringDestinationIds

    string[] facoltativo

    Gli ID dei display di destinazione del mirroring. Questo valore è valido solo per "mixed".

  • mirroringSourceId

    stringa facoltativa

    L'ID del display di origine del mirroring. Questo valore è valido solo per "mixed".

  • modalità

    MirrorMode

    La modalità Specchio da impostare.

Point

Chrome 57 e versioni successive

Proprietà

  • x

    numero

    La coordinata x del punto.

  • y

    numero

    La coordinata y del punto.

TouchCalibrationPair

Chrome 57 e versioni successive

Proprietà

  • displayPoint

    Point

    Le coordinate del punto di visualizzazione.

  • touchPoint

    Point

    Le coordinate del punto di contatto corrispondente al punto di visualizzazione.

TouchCalibrationPairQuad

Chrome 57 e versioni successive

Proprietà

  • Prima coppia di punti di tocco e visualizzazione richiesta per la calibrazione del tocco.

  • Seconda coppia di punti di tocco e visualizzazione richiesta per la calibrazione del tocco.

  • Terza coppia di punti di tocco e visualizzazione richiesta per la calibrazione del tocco.

  • Quarta coppia di punti di tocco e visualizzazione richiesta per la calibrazione del tocco.

Metodi

clearTouchCalibration()

Chrome 57 e versioni successive 
chrome.system.display.clearTouchCalibration(
  id: string,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Reimposta la calibrazione del tocco per il display e la riporta allo stato predefinito cancellando tutti i dati di calibrazione del tocco associati al display.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

completeCustomTouchCalibration()

Chrome 57 e versioni successive 
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Imposta le coppie di calibrazione del tocco per un display. Questi pairs verranno utilizzati per calibrare il touch screen per il display con id chiamato in startCustomTouchCalibration(). Chiama sempre startCustomTouchCalibration prima di chiamare questo metodo. Se è già in corso un'altra calibrazione del tocco, verrà generato un errore.

Parametri

  • Le coppie di punti utilizzate per calibrare il display.

  • bounds

    Limiti

    Limiti del display quando è stata eseguita la calibrazione del tocco. I valori bounds.left e bounds.top vengono ignorati.

enableUnifiedDesktop()

Chrome 46+ 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Attiva/disattiva la funzionalità desktop unificato. Se l'impostazione viene attivata mentre il mirroring è attivo, la modalità desktop non cambierà finché il mirroring non verrà disattivato. In caso contrario, la modalità desktop passerà immediatamente a unificata.

Parametri

  • attivato

    booleano

    True se il desktop unificato deve essere attivato.

getDisplayLayout()

Promise Chrome 53 e versioni successive 
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Richiede le informazioni sul layout per tutti i display.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (layouts: DisplayLayout[]) => void

Resi

  • Promise<DisplayLayout[]>

    Chrome 91 e versioni successive

    Promise che si risolve con i risultati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getInfo()

Promise 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): Promise<DisplayUnitInfo[]>

Richiede le informazioni per tutti i dispositivi di visualizzazione collegati.

Parametri

  • bandiere

    GetInfoFlags facoltativo

    Chrome 59 e versioni successive

    Opzioni che influiscono sul modo in cui vengono restituite le informazioni.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (displayInfo: DisplayUnitInfo[]) => void

Resi

  • Promise<DisplayUnitInfo[]>

    Chrome 91 e versioni successive

    Promise che si risolve con i risultati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

overscanCalibrationAdjust()

Chrome 53 e versioni successive 
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Regola gli inset di overscan correnti per un display. In genere, questo dovrebbe spostare il display lungo un asse (ad es. sinistra+destra hanno lo stesso valore) o scalarlo lungo un asse (ad es. alto+basso hanno valori opposti). Ogni chiamata Adjust è cumulativa con le chiamate precedenti dall'avvio.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • Delta

    Riquadri

    La quantità di modifica degli inset di overscan.

overscanCalibrationComplete()

Chrome 53 e versioni successive 
chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Completa le regolazioni dell'overscan per un display salvando i valori correnti e nascondendo l'overlay.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

overscanCalibrationReset()

Chrome 53 e versioni successive 
chrome.system.display.overscanCalibrationReset(
  id: string,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Reimposta gli inset di overscan di un display sull'ultimo valore salvato (ovvero prima della chiamata di Start).

Parametri

  • id

    stringa

    L'identificatore univoco del display.

overscanCalibrationStart()

Chrome 53 e versioni successive 
chrome.system.display.overscanCalibrationStart(
  id: string,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Avvia la calibrazione dell'overscan per un display. In questo modo, sullo schermo verrà visualizzato un overlay che indica gli inset di overscan correnti. Se la calibrazione dell'overscan per il display id è in corso, la calibrazione verrà reimpostata.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

setDisplayLayout()

Promise Chrome 53 e versioni successive 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Imposta il layout per tutti i display. I display non inclusi utilizzeranno il layout predefinito. Se un layout si sovrappone o non è valido, verrà modificato in un layout valido. Una volta risolto il layout, verrà attivato un evento onDisplayChanged.

Parametri

  • Layout

    DisplayLayout[]

    Le informazioni sul layout, obbligatorie per tutti i display, ad eccezione di quello principale.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Promessa che si risolve al termine della funzione.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setDisplayProperties()

Promise 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Aggiorna le proprietà del display specificato da id, in base alle informazioni fornite in info. In caso di errore, verrà impostato runtime.lastError.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • informazioni

    DisplayProperties

    Le informazioni sulle proprietà di visualizzazione che devono essere modificate. Una proprietà verrà modificata solo se viene specificato un nuovo valore in info.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Promessa che si risolve al termine della funzione.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setMirrorMode()

Promise Chrome 65 e versioni successive 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Imposta la modalità di visualizzazione sulla modalità Specchio specificata. Ogni chiamata reimposta lo stato delle chiamate precedenti. La chiamata a setDisplayProperties() non andrà a buon fine per i display di destinazione del mirroring.

Parametri

  • informazioni

    MirrorModeInfo

    Le informazioni della modalità Specchio che devono essere applicate alla modalità di visualizzazione.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 91 e versioni successive

    Promessa che si risolve al termine della funzione.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

showNativeTouchCalibration()

Promise Chrome 57 e versioni successive 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Visualizza la UX di calibrazione del tocco nativa per il display con id come ID display. Sullo schermo verrà visualizzato un overlay con le istruzioni necessarie su come procedere. Il callback verrà richiamato solo in caso di calibrazione riuscita. Se la calibrazione non va a buon fine, verrà generato un errore.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (success: boolean) => void

    • operazione riuscita

      booleano

Resi

  • Promise<boolean>

    Chrome 91 e versioni successive

    Promise che si risolve per informare il chiamante che la calibrazione del tocco è terminata. Il valore booleano indica se la calibrazione è andata a buon fine o meno.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

startCustomTouchCalibration()

Chrome 57 e versioni successive 
chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

NOTA: questa opzione è disponibile solo per le app kiosk di ChromeOS. Avvia la calibrazione personalizzata del tocco per un display. Questo metodo deve essere chiamato quando si utilizza una UX personalizzata per la raccolta dei dati di calibrazione. Se è già in corso un'altra calibrazione del tocco, verrà generato un errore.

Parametri

  • id

    stringa

    L'identificatore univoco del display.

Eventi

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

Attivato quando viene apportata una modifica alla configurazione del display.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void