log.entryAdded Event

Ereignisdaten

Das params Feld in der Ereignisbenachrichtigung ist ein Logeintragsobjekt. Abhängig von der Quelle des Logs hat das Logeintragsobjekt verschiedene Typen: "console" oder "javascript". Jeder Typ kann zusätzliche, für diese Quelle spezifische Felder bereitstellen.

Gemeinsame Felder

Alle Logeintragsobjekte enthalten die folgenden Felder:

level

Ein String, der die Schwere des Logeintrags angibt. Es hat einen der folgenden Werte:

• "debug": Eine Debug-Nachricht (von console.debug() oder console.trace()).
• "info": Eine Informationsnachricht (von console.log(), console.info() und anderen Konsolenmethoden, die keine speziellere Ebene erzeugen).
• "warn": Eine Warnung (von console.warn()).
• "error": Eine Fehlermeldung (von console.error() oder console.assert()).

source

Ein Objekt, das den Realm identifiziert, in dem der Logeintrag erstellt wurde. Es enthält die folgenden Felder:

realm

Ein String, der die ID des Realm enthält.

context Optional

Ein String, der die ID des Kontextes enthält, in dem der Logeintrag erstellt wurde.

userContext Optional

Ein String, der die ID des Benutzerkontextes enthält, in dem das skriptbezogene Ereignis aufgetreten ist.

stackTrace Optional

Ein Objekt mit einem callFrames Array, das den JavaScript-Stack zu dem Zeitpunkt repräsentiert, als der Eintrag erstellt wurde. Jedes Element im Array ist ein Stack-Frame mit den folgenden Feldern: columnNumber, functionName, lineNumber, und url.

text

Ein String, der die Lognachricht enthält oder null, wenn nicht verfügbar. Bei Konsoleneinträgen ist es die Verkettung aller stringifizierten Argumente, getrennt durch Leerzeichen, und bei JavaScript-Fehlern ist es im Allgemeinen die Fehlermeldung. Das exakte Format ist browserabhängig, daher sollten Sie sich nicht auf diesen Wert für Überprüfungen in Tests verlassen.

timestamp

Eine nicht-negative Ganzzahl, die die Zeit repräsentiert, zu der der Logeintrag erstellt wurde, in Millisekunden seit der Epoche (Date.now()).

type

Ein String, der die Quelle des Logeintrags identifiziert. Es hat einen der folgenden Werte:

• "console": Gibt an, dass der Logeintrag durch einen Aufruf einer Konsolen-API-Methode (zum Beispiel console.log(), console.warn()) generiert wurde. Logeintragsobjekte dieses Typs enthalten zusätzliche Felder.
• "javascript": Gibt an, dass der Logeintrag durch einen nicht abgefangenen JavaScript-Fehler generiert wurde.

"console" Logeintragsfelder

Zusätzlich zu den gemeinsamen Feldern enthalten Logeintragsobjekte mit "type": "console" auch:

args

Ein Array von Objekten, die die an die Konsolenmethode übergebenen Argumente repräsentieren. Jedes Objekt hat ein type Feld (wie "string", "number", "boolean", oder "array") und optionale value, handle, und internalId Felder.

method

Ein String, der den Namen der aufgerufenen Konsolenmethode enthält (zum Beispiel, "log", "error", "assert", "debug", "trace", "warn").

Beispiele

Empfang eines Ereignisses für ein Konsolen-Log

Mit einer WebDriver BiDi Verbindung und einem Abonnement für log.entryAdded aktiv sendet der Browser ein log.entryAdded Ereignis, wenn ein Skript console.log("hello", [1, true, "foo"]) auswertet:

{
  "type": "event",
  "method": "log.entryAdded",
  "params": {
    "type": "console",
    "method": "log",
    "source": {
      "realm": "7c37f4c0-abcd-1234-ef56-789012345678",
      "context": "6B3D5B3A-6571-432B-8E96-E53B5C2ECBB5"
    },
    "args": [
      {
        "type": "string",
        "value": "hello"
      },
      {
        "type": "array",
        "value": [
          { "type": "number", "value": 1 },
          { "type": "boolean", "value": true },
          { "type": "string", "value": "foo" }
        ]
      }
    ],
    "level": "info",
    "text": "hello 1,true,foo",
    "timestamp": 1712345678901,
    "stackTrace": {
      "callFrames": [
        {
          "columnNumber": 8,
          "functionName": "",
          "lineNumber": 1,
          "url": "https://example.com/app.js"
        }
      ]
    }
  }
}

Empfang eines Ereignisses für eine Konsolenwarnung

Mit einer WebDriver BiDi Verbindung und einem Abonnement für log.entryAdded aktiv sendet der Browser ein log.entryAdded Ereignis, wenn ein Skript console.warn("something went wrong") auswertet:

{
  "type": "event",
  "method": "log.entryAdded",
  "params": {
    "type": "console",
    "method": "warn",
    "source": {
      "realm": "7c37f4c0-abcd-1234-ef56-789012345678",
      "context": "6B3D5B3A-6571-432B-8E96-E53B5C2ECBB5"
    },
    "args": [
      {
        "type": "string",
        "value": "something went wrong"
      }
    ],
    "level": "warn",
    "text": "something went wrong",
    "timestamp": 1712345678950,
    "stackTrace": {
      "callFrames": [
        {
          "columnNumber": 8,
          "functionName": "",
          "lineNumber": 1,
          "url": "https://example.com/app.js"
        }
      ]
    }
  }
}

Empfang eines Ereignisses für einen nicht abgefangenen JavaScript-Fehler

Mit einer WebDriver BiDi Verbindung und einem Abonnement für log.entryAdded aktiv sendet der Browser ein log.entryAdded Ereignis, wenn ein nicht abgefangener JavaScript-Fehler auftritt:

{
  "type": "event",
  "method": "log.entryAdded",
  "params": {
    "type": "javascript",
    "level": "error",
    "source": {
      "realm": "7c37f4c0-abcd-1234-ef56-789012345678",
      "context": "6B3D5B3A-6571-432B-8E96-E53B5C2ECBB5"
    },
    "text": "ReferenceError: undefinedVariable is not defined",
    "timestamp": 1712345679100,
    "stackTrace": {
      "callFrames": [
        {
          "columnNumber": 27,
          "functionName": "",
          "lineNumber": 3,
          "url": "https://example.com/app.js"
        },
        {
          "columnNumber": 18,
          "functionName": "",
          "lineNumber": 3,
          "url": "https://example.com/app.js"
        }
      ]
    }
  }
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• session.subscribe Befehl
• console API