chrome.system.display

Beschreibung

Verwenden Sie die system.display API, um Anzeigemetadaten abzufragen.

Berechtigungen

system.display

Typen

ActiveState

Chrome 117 oder höher

Ein Enum-Wert, der angibt, ob der Bildschirm vom System erkannt und verwendet wird. Das Display gilt als „inaktiv“, wenn es vom System nicht erkannt wird (z. B. nicht verbunden oder aufgrund des Schlafmodus als nicht verbunden angesehen). Dieser Status wird verwendet, um einen vorhandenen Bildschirm beizubehalten, wenn alle Bildschirme getrennt sind, z. B.

Enum

"aktiv"

"inaktiv"

Bounds

Attribute

  • Höhe

    Zahl

    Die Höhe der Anzeige in Pixeln.

  • links

    Zahl

    Die X-Koordinate der linken oberen Ecke.

  • oben

    Zahl

    Die Y-Koordinate der linken oberen Ecke.

  • Breite

    Zahl

    Die Breite des Bildschirms in Pixeln.

DisplayLayout

Chrome (ab Version 53)

Attribute

  • id

    String

    Die eindeutige Kennung des Displays.

  • kompensiert

    Zahl

    Der Versatz des Displays entlang der verbundenen Kante. 0 bedeutet, dass die obere oder die äußerste linke Ecke ausgerichtet ist.

  • parentId

    String

    Die eindeutige ID des übergeordneten Bildschirms. Leer, wenn dies der Stamm ist.

  • position

    LayoutPosition

    Die Layoutposition dieser Anzeige relativ zum übergeordneten Element. Dies wird für das Stammverzeichnis ignoriert.

DisplayMode

Chrome 52 und höher

Attribute

  • deviceScaleFactor

    Zahl

    Der Skalierungsfaktor des Geräts im Anzeigemodus.

  • Höhe

    Zahl

    Die Höhe im Anzeigemodus in geräteunabhängigen (für Nutzer sichtbaren) Pixeln.

  • heightInNativePixels

    Zahl

    Die Höhe des Anzeigemodus in nativen Pixeln.

  • isInterlaced

    Boolescher Wert optional

    Chrome 74 und höher

    "True", wenn dieser Modus verschachtelt ist, "False", wenn nicht angegeben.

  • isNative

    boolean

    „True“, wenn der Modus der native Modus des Displays ist.

  • isSelected

    boolean

    „True“, wenn der Anzeigemodus derzeit ausgewählt ist.

  • refreshRate

    Zahl

    Chrome 67 und höher

    Die Aktualisierungsrate im Anzeigemodus in Hertz.

  • uiScale

    Zahl optional

    <ph type="x-smartling-placeholder"></ph> Seit Chrome 70 verworfen

    „displayZoomFactor“ verwenden

    Skalierungsfaktor der Benutzeroberfläche für den Anzeigemodus

  • Breite

    Zahl

    Die Breite des Anzeigemodus in geräteunabhängigen (für Nutzer sichtbaren) Pixeln.

  • widthInNativePixels

    Zahl

    Die Breite des Anzeigemodus in nativen Pixeln.

DisplayProperties

Attribute

  • boundsOriginX

    Zahl optional

    Wenn dieser Wert festgelegt ist, wird der Ursprung der logischen Begrenzungen der Anzeige entlang der x-Achse aktualisiert. Wird zusammen mit boundsOriginY angewendet. Wenn kein Wert festgelegt ist und boundsOriginY festgelegt ist, wird standardmäßig der aktuelle Wert verwendet. Beachten Sie, dass beim Aktualisieren des angezeigten Ursprungs einige Einschränkungen angewendet werden, sodass der endgültige Ursprung der Grenzen möglicherweise vom festgelegten Ursprung abweicht. Die endgültigen Grenzen können mit getInfo abgerufen werden. Der Ursprung der Grenzen kann auf der primären Anzeige nicht geändert werden.

  • boundsOriginY

    Zahl optional

    Aktualisiert den logischen Begrenzungsursprung der Anzeige entlang der Y-Achse, wenn dieser Wert festgelegt ist. Weitere Informationen finden Sie in der Dokumentation zum Parameter boundsOriginX.

  • displayMode

    DisplayMode optional

    Chrome 52 und höher

    Aktualisiert den Anzeigemodus auf den Modus, der diesem Wert entspricht. Sind andere Parameter ungültig, wird dies nicht angewendet. Wenn der Anzeigemodus ungültig ist, wird er nicht angewendet und ein Fehler angezeigt. Andere Eigenschaften werden aber trotzdem angewendet.

  • displayZoomFactor

    Zahl optional

    Chrome 65 und höher

    Aktualisiert den mit der Anzeige verknüpften Zoom. Bei diesem Zoom wird das Layout neu gestaltet und die Darstellung angepasst, was zu einer besseren Zoomqualität führt als nur eine Pixel-für-Pixel-Streckvergrößerung.

  • istprimär

    Boolescher Wert optional

    Wenn die Richtlinie auf „true“ gesetzt ist, wird die Anzeige als primär festgelegt. Managementfrei, wenn auf „false“ gesetzt. Hinweis: Wenn dies festgelegt ist, wird die Anzeige bei allen anderen Properties als primäre Anzeige angesehen, d.h., isUnified kann festgelegt werden und der Grenzübersprung nicht.

  • isUnified

    Boolescher Wert optional

    Chrome 59 und höher

    Nur ChromeOS Wenn die Richtlinie auf „true“ gesetzt ist, wird der Anzeigemodus in Unified Desktop geändert. Weitere Informationen finden Sie unter enableUnifiedDesktop. Wenn die Richtlinie auf „false“ gesetzt ist, wird der Unified Desktop-Modus deaktiviert. Dies gilt nur für den primären Bildschirm. Wenn angegeben, darf mirroringSourceId nicht angegeben werden. Andere Attribute werden ignoriert. Ohne Angabe hat dies keine Auswirkungen.

  • mirroringSourceId

    String optional

    <ph type="x-smartling-placeholder"></ph> Eingestellt seit Chrome 68

    Verwenden Sie setMirrorMode.

    Nur ChromeOS Wenn festgelegt und nicht leer, wird die Spiegelung nur für diese Anzeige aktiviert. Andernfalls wird die Spiegelung für alle Bildschirme deaktiviert. Dieser Wert sollte die ID der zu spiegelnden Quellanzeige angeben. Sie darf nicht mit der an „setDisplayProperties“ übergebenen ID übereinstimmen. Wenn festgelegt, kann keine andere Property festgelegt werden.

  • Overscan

    Einsätze optional

    Wenn festgelegt, werden die Overscan-Einsätze der Anzeige auf die angegebenen Werte festgelegt. Beachten Sie, dass Overscan-Werte nicht negativ oder größer als die Hälfte des Bildschirms sein dürfen. Der Overscan kann auf dem internen Monitor nicht geändert werden.

  • Rotation

    Zahl optional

    Aktualisiert die Drehung der Anzeige. Die zulässigen Werte sind [0, 90, 180, 270]. Die Drehung erfolgt im Uhrzeigersinn relativ zur vertikalen Position des Bildschirms.

DisplayUnitInfo

Attribute

  • activeState

    ActiveState

    Chrome 117 oder höher

    Aktiv, wenn das Display vom System erkannt und verwendet wird.

  • availableDisplayZoomFactors

    Zahl[]

    Chrome 67 und höher

    Eine Liste der Zoomfaktorwerte, die für die Anzeige festgelegt werden können.

  • Grenzen

    Grenzen

    Die logischen Grenzen der Anzeige.

  • displayZoomFactor

    Zahl

    Chrome 65 und höher

    Das Verhältnis zwischen dem aktuellen und dem Standardzoom der Anzeige. Beispiel: Wert 1 entspricht 100% Zoom und Wert 1,5 entspricht 150% Zoom.

  • dpiX

    Zahl

    Die Anzahl der Pixel pro Zoll entlang der X-Achse.

  • dpiY

    Zahl

    Die Anzahl der Pixel pro Zoll entlang der Y-Achse.

  • EID

    Edid optional

    Chrome 67 und höher

    HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.

  • hasTouchSupport

    boolean

    Chrome 57 und höher

    "True", wenn diesem Display ein Touch-Eingabegerät zugeordnet ist.

  • id

    String

    Die eindeutige Kennung des Displays.

  • isEnabled

    boolean

    „True“, wenn diese Anzeige aktiviert ist.

  • istprimär

    boolean

    „True“, wenn dies der primäre Bildschirm ist.

  • isUnified

    boolean

    Chrome 59 und höher

    „True“ für alle Displays im Unified Desktop-Modus. Siehe Dokumentation zu enableUnifiedDesktop.

  • mirroringDestinationIds

    String[]

    Chrome (ab Version 64)

    Nur ChromeOS IDs der Bildschirme, auf denen die Quellanzeige gespiegelt wird. Leer, wenn keine Bildschirme gespiegelt werden. Dieser wird für alle Bildschirme auf denselben Wert festgelegt. mirroringSourceId darf nicht enthalten sein.

  • mirroringSourceId

    String

    Nur ChromeOS ID des Bildschirms, der gespiegelt wird, wenn die Spiegelung aktiviert ist. Andernfalls ist das Feld leer. Diese Einstellung wird für alle Bildschirme festgelegt, auch für den gespiegelten Bildschirm.

  • Modi

    DisplayMode[]

    Chrome 52 und höher

    Die Liste der verfügbaren Anzeigemodi. Im aktuellen Modus ist isSelected=true. Nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf ein leeres Array festgelegt.

  • Name

    String

    Der nutzerfreundliche Name (z.B. "HP LCD-Monitor").

  • Overscan

    Einsätze

    Die Einfügungen des Bildschirms innerhalb der Bildschirmgrenzen. Derzeit nur unter ChromeOS verfügbar. Sie werden auf anderen Plattformen auf leere Einsätze festgelegt.

  • Rotation

    Zahl

    Die Drehung des Bildschirms im Uhrzeigersinn in Grad relativ zur vertikalen Position. Derzeit nur unter ChromeOS verfügbar. Wird auf anderen Plattformen auf „0“ gesetzt. Ein Wert von -1 wird als automatisches Drehen interpretiert, wenn sich das Gerät im Tablet-Status befindet.

  • workArea

    Grenzen

    Der nutzbare Arbeitsbereich der Anzeige innerhalb der Anzeigegrenzen. Der Arbeitsbereich schließt für das Betriebssystem reservierte Bereiche des Bildschirms aus, z. B. die Taskleiste und den Launcher.

Edid

Chrome 67 und höher

Attribute

  • manufacturerId

    String

    Dreistelliger Herstellercode. Siehe Abschnitt 3.4.1 Seite 21. In v1.4 erforderlich.

  • productId

    String

    2 Byte vom Hersteller zugewiesener Code, Sek. 3.4.2 Seite 21. In v1.4 erforderlich.

  • yearOfManufacture

    Zahl

    Jahr des Herstellers, Sek. 3.4.4 Seite 22. In v1.4 erforderlich.

GetInfoFlags

Chrome 59 und höher

Attribute

  • singleUnified

    Boolescher Wert optional

    Wenn die Richtlinie auf „true“ gesetzt ist, wird im Unified Desktop-Modus nur ein einzelnes DisplayUnitInfo von getInfo zurückgegeben (siehe enableUnifiedDesktop). Die Standardeinstellung ist „false“.

Insets

Attribute

  • unten

    Zahl

    Der Abstand der Y-Achse von der unteren Grenze.

  • links

    Zahl

    Der Abstand der x-Achse von der linken Grenze.

  • rechts

    Zahl

    Der Abstand der x-Achse von der rechten Grenze.

  • oben

    Zahl

    Der Abstand der Y-Achse von der oberen Grenze.

LayoutPosition

Chrome (ab Version 53)

Layoutposition, d. h. Rand des übergeordneten Elements, an dem der Bildschirm angebracht ist

Enum

"top"

"rechts"

"bottom"

"links"

MirrorMode

Chrome 65 und höher

Spiegelmodus, d.h. verschiedene Möglichkeiten, wie ein Display auf andere Displays gespiegelt wird.

Enum

"off"
Gibt den Standardmodus an (erweiterter Modus oder Unified Desktop).

"normal"
Gibt an, dass die Standard-Quellanzeige auf allen anderen Bildschirmen gespiegelt wird.

"mixed"
Gibt an, dass die angegebene Quellanzeige auf den angegebenen Zieldisplays gespiegelt wird. Alle anderen verbundenen Displays werden erweitert.

MirrorModeInfo

Chrome 65 und höher

Attribute

  • mirroringDestinationIds

    string[] optional

    Die IDs der gespiegelten Zielobjekte. Dies gilt nur für „gemischt“.

  • mirroringSourceId

    String optional

    Die ID der gespiegelten Quellanzeige. Dies gilt nur für „gemischt“.

  • Modus

    MirrorMode

    Der festzulegende Spiegelmodus.

Point

Chrome 57 und höher

Attribute

  • x

    Zahl

    Die X-Koordinate des Punkts.

  • y

    Zahl

    Die Y-Koordinate des Punkts.

TouchCalibrationPair

Chrome 57 und höher

Attribute

  • displayPoint

    Zugangspunkt

    Die Koordinaten des Anzeigepunkts.

  • touchPoint

    Zugangspunkt

    Die Koordinaten des Berührungspunkts, der dem Anzeigepunkt entspricht.

TouchCalibrationPairQuad

Chrome 57 und höher

Attribute

  • Für die Touch-Kalibrierung ist das erste Paar Touch- und Displaypunkt erforderlich.

  • Für die Touch-Kalibrierung ist ein zweites Paar Touch- und Displaypunkt erforderlich.

  • Für die Touch-Kalibrierung ist ein drittes Paar Touch- und Displaypunkt erforderlich.

  • Für die Touch-Kalibrierung ist das vierte Paar Touch- und Displaypunkt erforderlich.

Methoden

clearTouchCalibration()

Chrome 57 und höher 
chrome.system.display.clearTouchCalibration(
  id: string,
)

Setzt die Touch-Kalibrierung des Displays zurück und bringt es auf den Standardzustand zurück, indem alle Touch-Kalibrierungsdaten gelöscht werden, die mit dem Display verknüpft sind.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

completeCustomTouchCalibration()

Chrome 57 und höher 
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

Legt die Kalibrierungspaare für Touchscreens für einen Bildschirm fest. Diese pairs werden verwendet, um den Touchscreen für das Display mit id zu kalibrieren, der in „startCustomTouchCalibration()“ aufgerufen wird. Rufen Sie immer startCustomTouchCalibration auf, bevor Sie diese Methode aufrufen. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.

Parameter

  • Die Zugangspunkte, die zur Kalibrierung des Displays verwendet werden.

  • Grenzen

    Grenzen

    Grenzen des Displays bei Durchführung der Touch-Kalibrierung. Die Werte bounds.left und bounds.top werden ignoriert.

enableUnifiedDesktop()

Chrome (ab Version 46) 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

Aktiviert/deaktiviert die Unified Desktop-Funktion. Wenn diese Option aktiviert ist, während die Spiegelung aktiv ist, ändert sich der Desktopmodus erst, wenn die Spiegelung deaktiviert wird. Andernfalls wechselt der Desktopmodus sofort in den vereinheitlichten Modus. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.

Parameter

  • aktiviert

    boolean

    „True“, wenn Unified Desktop aktiviert werden soll.

getDisplayLayout()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 53 und höher 
chrome.system.display.getDisplayLayout(
  callback?: function,
)

Fordert die Layoutinformationen für alle Bildschirme an. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (layouts: DisplayLayout[]) => void

Gibt Folgendes zurück:

  • Promise&lt;DisplayLayout[]&gt;

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getInfo()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

Fordert die Informationen für alle angeschlossenen Anzeigegeräte an.

Parameter

  • flags

    GetInfoFlags optional

    Chrome 59 und höher

    Optionen, die beeinflussen, wie die Informationen zurückgegeben werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (displayInfo: DisplayUnitInfo[]) => void

Gibt Folgendes zurück:

  • Promise&lt;DisplayUnitInfo[]&gt;

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

overscanCalibrationAdjust()

Chrome (ab Version 53) 
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

Passt die aktuellen Overscan-Einsätze für eine Anzeige an. In der Regel wird die Anzeige dabei entweder entlang einer Achse verschoben (z.B. hat links + rechts den gleichen Wert) oder sie wird entlang einer Achse skaliert (z.B. haben oben und unten entgegengesetzte Werte). Jeder Anpassungsanruf wird mit den vorherigen Anrufen seit dem Start gezählt.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

  • delta

    Einsätze

    Der Wert, um den die Overscan-Einsätze geändert werden sollen.

overscanCalibrationComplete()

Chrome (ab Version 53) 
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

Schließen Sie die Overscan-Anpassungen für eine Anzeige ab, indem Sie die aktuellen Werte speichern und das Overlay ausblenden.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

overscanCalibrationReset()

Chrome (ab Version 53) 
chrome.system.display.overscanCalibrationReset(
  id: string,
)

Setzt die Overscan-Einsätze für eine Anzeige auf den zuletzt gespeicherten Wert (d. h. vor Aufruf des Starts) zurück.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

overscanCalibrationStart()

Chrome (ab Version 53) 
chrome.system.display.overscanCalibrationStart(
  id: string,
)

Startet die Overscan-Kalibrierung für einen Bildschirm. Dadurch wird ein Overlay auf dem Bildschirm angezeigt, das die aktuellen Overscan-Einsätze anzeigt. Wenn eine Overscan-Kalibrierung für das Display „id“ ausgeführt wird, wird die Kalibrierung zurückgesetzt.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

setDisplayLayout()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 53 und höher 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

Lege das Layout für alle Bildschirme fest. Alle nicht enthaltenen Displays verwenden das Standardlayout. Wenn sich ein Layout überschneidet oder anderweitig ungültig wäre, wird es an ein gültiges Layout angepasst. Nachdem das Layout aufgelöst wurde, wird ein onDisplayChanged-Ereignis ausgelöst. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.

Parameter

  • Layouts

    DisplayLayout[]

    Die Layoutinformationen, die für alle Bildschirme außer dem primären Bildschirm erforderlich sind.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setDisplayProperties()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

Aktualisiert die Eigenschaften für die durch id angegebene Anzeige gemäß den Informationen in info. Bei einem Fehler wird runtime.lastError festgelegt. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

  • Die Informationen zu Anzeigeeigenschaften, die geändert werden sollen. Eine Eigenschaft wird nur geändert, wenn in info ein neuer Wert dafür angegeben ist.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setMirrorMode()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 65 und höher 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

Legt den Anzeigemodus auf den angegebenen Spiegelmodus fest. Bei jedem Aufruf wird der Status vorheriger Aufrufe zurückgesetzt. Der Aufruf von „setDisplayProperties()“ schlägt für die Anzeigeziele des Spiegelungsziels fehl. HINWEIS: Diese Funktion ist nur für die Chrome OS-Kiosk-Apps und die Web-UI verfügbar.

Parameter

  • Die Informationen zum Spiegelungsmodus, der auf den Anzeigemodus angewendet werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

showNativeTouchCalibration()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 57 und höher 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

Zeigt die UX für die native Touch-Kalibrierung für den Bildschirm mit id als Display-ID an. Nun erscheint auf dem Bildschirm ein Overlay mit einer Anleitung zum weiteren Vorgehen. Der Callback wird nur im Fall einer erfolgreichen Kalibrierung aufgerufen. Wenn die Kalibrierung fehlschlägt, wird ein Fehler ausgegeben.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (success: boolean) => void

    • Erfolg

      boolean

Gibt Folgendes zurück:

  • Promise&lt;boolean&gt;

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

startCustomTouchCalibration()

Chrome 57 und höher 
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

Startet die benutzerdefinierte Touch-Kalibrierung für einen Bildschirm. Diese sollte aufgerufen werden, wenn eine benutzerdefinierte UX zum Erfassen von Kalibrierungsdaten verwendet wird. Wenn bereits eine andere Touch-Kalibrierung durchgeführt wird, wird ein Fehler ausgegeben.

Parameter

  • id

    String

    Die eindeutige Kennung des Displays.

Ereignisse

onDisplayChanged

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

Wird ausgelöst, wenn sich etwas an der Anzeigekonfiguration ändert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void