Dieser Abschnitt listet die am häufigsten auftretenden JavaScript-Fehler auf, die von unserer Community gemeldet wurden.

Dieser Fehler (ebenso wie der unten genannte) tritt in der Regel auf, wenn Sie versuchen, den Tracker in einem serverseitigen Kontext (SSR, Nuxt-, Next-, Remix-Apps usw.) zu importieren.

Zur Behebung müssen Sie sicherstellen, dass der Tracker im Browser-Kontext importiert und ausgeführt wird – etwa über dynamische Imports, Client-Komponenten usw.

Dieser Fehler tritt manchmal auf, wenn Sie versuchen, die Plugins tracker-assist oder tracker-fetch zu importieren. Der Grund: Node versucht, die Seite ohne die window-API in der Umgebung zu erstellen.

Die Lösung ist recht einfach: Ändern Sie den regulären Import des problematischen Plugins:

import trackerAssist from '@openreplay/tracker-assist/cjs';

Importieren Sie es stattdessen dynamisch innerhalb von componendDidMount oder der Alternative useEffect:

import Tracker, { Options } from "@openreplay/tracker";
const tracker = new Tracker({ /* your options */ });

class TrackerComponent extends React.Component {

  componentDidMount = () => {
    import(‘@openreplay/tracker-assist/cjs’).then(({ default: trackerAssist }) => {
      tracker.start(/* your options */)
      tracker.use(trackerAssist(/* your assist options */))
    })
   }

 /* Other code */

Auf diese Weise werden alle Plugins, die von der window-API abhängen, erst beim Rendern der Komponente importiert.

Das kann bei älteren Versionen des Plugins tracker-assist auftreten. Wenden Sie diesen Workaround an, wenn beim Kompilieren der folgende Fehler auftritt:

Failed to compile.

./node_modules/peerjs/dist/peerjs.min.js
Critical dependency: the request of a dependency is an expression

Der OpenReplay-Tracker erfasst standardmäßig iFrames der gleichen Domain. Beim Versuch, einen iFrame zu erfassen, der NICHT von der gleichen Domain wie Ihre Website stammt, löst er jedoch einen Fehler aus. Sie haben folgende Möglichkeiten:

• Deaktivieren Sie die gesamte Funktion mit der Eigenschaft captureIFrames, wie im folgenden Beispiel gezeigt:

tracker.configure({
      projectKey: PROJECT_KEY,
      captureIFrames: false
});

• Erfassen Sie iFrames weiterhin (Standardverhalten), indem Sie das HTML-Attribut data-openreplay-capture ausschließlich zu den <iframe>-Tags der gleichen Domain hinzufügen. Auf diese Weise werden Cross-Origin-iFrames nicht von OpenReplay erfasst.

Wenn Sie auf Fehler stoßen, die auf dieser Seite nicht aufgeführt sind, können Sie gerne ein Issue erstellen oder sich einfach an unseren Slack wenden, um Hilfe aus unserer Community zu erhalten.

Wenn Sie Fragen zu diesem Vorgang haben, wenden Sie sich gerne über unseren Slack an uns.