Skip to content

Commit

Permalink
tracy: AJAX debugging
Browse files Browse the repository at this point in the history
  • Loading branch information
dg committed May 14, 2024
1 parent 84606cf commit c63c266
Show file tree
Hide file tree
Showing 16 changed files with 448 additions and 48 deletions.
31 changes: 28 additions & 3 deletions tracy/bg/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ header("Content-Security-Policy: script-src 'nonce-$nonce' 'strict-dynamic';");
```


AJAX и пренасочени заявки .[#toc-ajax-and-redirected-requests]
==============================================================
Отстраняване на грешки при заявките AJAX .[#toc-debugging-ajax-requests]
========================================================================

Трейси може да показва Debug bar и Bluescreens за AJAX заявки и пренасочвания. Tracy създава свои собствени сесии, съхранява данни в свои собствени временни файлове и използва бисквитка `tracy-session`.
Tracy автоматично улавя заявките AJAX, направени с помощта на jQuery или родния API на `fetch`. Тези заявки се показват като допълнителни редове в лентата Tracy, което позволява лесно и удобно отстраняване на грешки в AJAX.

Ако не искате да улавяте автоматично AJAX заявки, можете да деактивирате тази функция, като зададете JavaScript променливата:

```js
window.TracyAutoRefresh = false;
```

За ръчно следене на конкретни AJAX заявки добавете HTTP заглавието `X-Tracy-Ajax` със стойността, върната от `Tracy.getAjaxHeader()`. Ето пример за използването му с функцията `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Този подход позволява селективно отстраняване на грешки в AJAX заявките.


Съхранение на данни .[#toc-data-storage]
========================================

Tracy може да показва панели Tracy bar и Bluescreens за AJAX заявки и пренасочвания. Tracy създава свои собствени сесии, съхранява данни в свои собствени временни файлове и използва бисквитка `tracy-session`.

Tracy може също така да бъде конфигуриран да използва собствена PHP сесия, която се стартира преди Tracy да бъде включен:

Expand Down
31 changes: 28 additions & 3 deletions tracy/cs/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ Spuštění je přímočaré, pokud však máte na webové stránce pomalu nač
```


AJAX a přesměrování
===================
Ladění AJAXový požadavků
========================

Tracy umí zobrazit Debug bar a Bluescreeny pro AJAXové požadavky a přesměrovaní. Tracy si vytváří vlastní session, data uchovává ve vlastních dočasných souborech a používá cookie `tracy-session`.
Tracy automaticky zachycuje AJAXové požadavky vytvořené pomocí jQuery nebo nativního API `fetch`. Požadavky jsou v liště Tracy zobrazeny jako další řádky, což umožňuje snadné a pohodlné ladění AJAXu.

Pokud nechcete AJAXové požadavky zachycovat automaticky, můžete tuto funkci zakázat nastavením JavaScriptové proměnné:

```js
window.TracyAutoRefresh = false;
```

Pro ruční monitorování specifických AJAX požadavků přidejte HTTP hlavičku `X-Tracy-Ajax` s hodnotou, kterou vrátí `Tracy.getAjaxHeader()`. Zde je příklad použití s funkcí `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Tento přístup umožňuje selektivní ladění AJAX požadavků.


Datové úložiště
===============

Tracy umí zobrazit panely v Tracy baru a Bluescreeny pro AJAXové požadavky a přesměrovaní. Tracy si vytváří vlastní session, data uchovává ve vlastních dočasných souborech a používá cookie `tracy-session`.

Tracy lze nakonfigurovat také tak, aby používala nativní PHP session, kterou nastartujeme ještě před zapnutím Tracy:

Expand Down
31 changes: 28 additions & 3 deletions tracy/de/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ Die Lösung ist, dass Sie `<?php Tracy\Debugger::renderLoader() ?>` in Ihre Vorl
```


AJAX und umgeleitete Anfragen .[#toc-ajax-and-redirected-requests]
==================================================================
Fehlersuche bei AJAX-Anfragen .[#toc-debugging-ajax-requests]
=============================================================

Tracy erfasst automatisch AJAX-Anfragen, die mit jQuery oder der systemeigenen API `fetch` gestellt werden. Diese Anfragen werden als zusätzliche Zeilen in der Tracy-Leiste angezeigt, was ein einfaches und bequemes AJAX-Debugging ermöglicht.

Wenn Sie nicht möchten, dass AJAX-Anfragen automatisch erfasst werden, können Sie diese Funktion durch Setzen der JavaScript-Variable deaktivieren:

```js
window.TracyAutoRefresh = false;
```

Für die manuelle Überwachung bestimmter AJAX-Anfragen fügen Sie den HTTP-Header `X-Tracy-Ajax` mit dem von `Tracy.getAjaxHeader()` zurückgegebenen Wert hinzu. Hier ist ein Beispiel für die Verwendung mit der Funktion `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Dieser Ansatz ermöglicht ein selektives Debugging von AJAX-Anfragen.


Datenspeicherung .[#toc-data-storage]
=====================================

Tracy kann Debug-Balken und Bluescreens für AJAX-Anfragen und Redirects anzeigen. Tracy erstellt seine eigenen Sitzungen, speichert Daten in seinen eigenen temporären Dateien und verwendet ein `tracy-session` Cookie.
Tracy kann Tracy-Leisten und Bluescreens für AJAX-Anfragen und Weiterleitungen anzeigen. Tracy erstellt seine eigenen Sitzungen, speichert Daten in seinen eigenen temporären Dateien und verwendet ein `tracy-session` Cookie.

Tracy kann auch so konfiguriert werden, dass es eine native PHP-Sitzung verwendet, die gestartet wird, bevor Tracy eingeschaltet wird:

Expand Down
31 changes: 28 additions & 3 deletions tracy/el/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ header("Content-Security-Policy: script-src 'nonce-$nonce' 'strict-dynamic';");
```


AJAX και ανακατευθυνόμενες αιτήσεις .[#toc-ajax-and-redirected-requests]
========================================================================
Αποσφαλμάτωση αιτημάτων AJAX .[#toc-debugging-ajax-requests]
============================================================

Το Tracy μπορεί να εμφανίσει τη γραμμή εντοπισμού σφαλμάτων και τα Bluescreens για αιτήσεις AJAX και ανακατευθύνσεις. Το Tracy δημιουργεί τις δικές του συνεδρίες, αποθηκεύει δεδομένα στα δικά του προσωρινά αρχεία και χρησιμοποιεί ένα cookie `tracy-session`.
Το Tracy καταγράφει αυτόματα τα αιτήματα AJAX που πραγματοποιούνται με τη χρήση του jQuery ή του εγγενούς API `fetch`. Αυτές οι αιτήσεις εμφανίζονται ως πρόσθετες γραμμές στη γραμμή Tracy, επιτρέποντας την εύκολη και βολική αποσφαλμάτωση AJAX.

Εάν δεν θέλετε να καταγράφετε αυτόματα τις αιτήσεις AJAX, μπορείτε να απενεργοποιήσετε αυτή τη λειτουργία ρυθμίζοντας τη μεταβλητή JavaScript:

```js
window.TracyAutoRefresh = false;
```

Για χειροκίνητη παρακολούθηση συγκεκριμένων αιτήσεων AJAX, προσθέστε την επικεφαλίδα HTTP `X-Tracy-Ajax` με την τιμή που επιστρέφει η `Tracy.getAjaxHeader()`. Ακολουθεί ένα παράδειγμα χρήσης της με τη συνάρτηση `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Αυτή η προσέγγιση επιτρέπει την επιλεκτική αποσφαλμάτωση των αιτήσεων AJAX.


Αποθήκευση δεδομένων .[#toc-data-storage]
=========================================

Το Tracy μπορεί να εμφανίζει πίνακες Tracy bar και Bluescreens για αιτήματα AJAX και ανακατευθύνσεις. Το Tracy δημιουργεί τις δικές του συνεδρίες, αποθηκεύει δεδομένα στα δικά του προσωρινά αρχεία και χρησιμοποιεί ένα cookie `tracy-session`.

Το Tracy μπορεί επίσης να ρυθμιστεί ώστε να χρησιμοποιεί μια εγγενή συνεδρία PHP, η οποία ξεκινά πριν από την ενεργοποίηση του Tracy:

Expand Down
31 changes: 28 additions & 3 deletions tracy/en/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ The solution is to place `<?php Tracy\Debugger::renderLoader() ?>` into your tem
```


AJAX and Redirected Requests
============================
Debugging AJAX Requests
=======================

Tracy automatically captures AJAX requests made using jQuery or the native `fetch` API. These requests are displayed as additional rows in the Tracy bar, enabling easy and convenient AJAX debugging.

If you do not want to capture AJAX requests automatically, you can disable this feature by setting the JavaScript variable:

```js
window.TracyAutoRefresh = false;
```

For manual monitoring of specific AJAX requests, add the HTTP header `X-Tracy-Ajax` with the value returned by `Tracy.getAjaxHeader()`. Here is an example of using it with the `fetch` function:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

This approach allows for selective debugging of AJAX requests.


Data Storage
============

Tracy can display Debug bar and Bluescreens for AJAX requests and redirects. Tracy creates its own sessions, stores data in its own temporary files, and uses a `tracy-session` cookie.
Tracy can display Tracy bar panels and Bluescreens for AJAX requests and redirects. Tracy creates its own sessions, stores data in its own temporary files, and uses a `tracy-session` cookie.

Tracy can also be configured to use a native PHP session, which is started before Tracy is turned on:

Expand Down
31 changes: 28 additions & 3 deletions tracy/es/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ La solución es colocar `<?php Tracy\Debugger::renderLoader() ?>` en tu plantill
```


AJAX y peticiones redirigidas .[#toc-ajax-and-redirected-requests]
==================================================================
Depuración de peticiones AJAX .[#toc-debugging-ajax-requests]
=============================================================

Tracy puede mostrar Debug bar y Bluescreens para peticiones AJAX y redirecciones. Tracy crea sus propias sesiones, almacena datos en sus propios archivos temporales y utiliza una cookie `tracy-session`.
Tracy captura automáticamente las peticiones AJAX realizadas mediante jQuery o la API nativa `fetch`. Estas peticiones se muestran como filas adicionales en la barra de Tracy, permitiendo una depuración AJAX fácil y cómoda.

Si no desea capturar automáticamente las solicitudes AJAX, puede desactivar esta función configurando la variable JavaScript:

```js
window.TracyAutoRefresh = false;
```

Para la monitorización manual de peticiones AJAX específicas, añada la cabecera HTTP `X-Tracy-Ajax` con el valor devuelto por `Tracy.getAjaxHeader()`. Aquí tiene un ejemplo de uso con la función `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Este enfoque permite la depuración selectiva de peticiones AJAX.


Almacenamiento de datos .[#toc-data-storage]
============================================

Tracy puede mostrar paneles de barras Tracy y Bluescreens para peticiones AJAX y redirecciones. Tracy crea sus propias sesiones, almacena datos en sus propios archivos temporales y utiliza una cookie `tracy-session`.

Tracy también puede configurarse para usar una sesión nativa PHP, que se inicia antes de que Tracy se active:

Expand Down
31 changes: 28 additions & 3 deletions tracy/fr/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ La solution consiste à placer `<?php Tracy\Debugger::renderLoader() ?>` dans vo
```


AJAX et requêtes redirigées .[#toc-ajax-and-redirected-requests]
================================================================
Débogage des requêtes AJAX .[#toc-debugging-ajax-requests]
==========================================================

Tracy capture automatiquement les requêtes AJAX effectuées à l'aide de jQuery ou de l'API native `fetch`. Ces requêtes sont affichées sous forme de lignes supplémentaires dans la barre de Tracy, ce qui permet un débogage AJAX facile et pratique.

Si vous ne souhaitez pas capturer automatiquement les requêtes AJAX, vous pouvez désactiver cette fonctionnalité en définissant la variable JavaScript :

```js
window.TracyAutoRefresh = false;
```

Pour surveiller manuellement des requêtes AJAX spécifiques, ajoutez l'en-tête HTTP `X-Tracy-Ajax` avec la valeur renvoyée par `Tracy.getAjaxHeader()`. Voici un exemple d'utilisation avec la fonction `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Cette approche permet un débogage sélectif des requêtes AJAX.


Stockage des données .[#toc-data-storage]
=========================================

Tracy peut afficher la barre de débogage et les écrans bleus pour les demandes AJAX et les redirections. Tracy crée ses propres sessions, stocke les données dans ses propres fichiers temporaires et utilise un cookie `tracy-session`.
Tracy peut afficher des panneaux de barre Tracy et des écrans bleus pour les requêtes AJAX et les redirections. Tracy crée ses propres sessions, stocke les données dans ses propres fichiers temporaires et utilise un cookie `tracy-session`.

Tracy peut également être configuré pour utiliser une session PHP native, qui est lancée avant que Tracy ne soit activé :

Expand Down
31 changes: 28 additions & 3 deletions tracy/hu/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ A megoldás az, hogy a `<?php Tracy\Debugger::renderLoader() ?>` a sablonba a sz
```


AJAX és átirányított kérések .[#toc-ajax-and-redirected-requests]
=================================================================
AJAX-kérelmek hibakeresése .[#toc-debugging-ajax-requests]
==========================================================

A Tracy megjelenítheti a hibakereső sávot és a Bluescreent az AJAX-kérések és átirányítások esetében. A Tracy saját munkameneteket hoz létre, az adatokat saját ideiglenes fájlokban tárolja, és a `tracy-session` cookie-t használja.
A Tracy automatikusan rögzíti a jQuery vagy a natív `fetch` API segítségével végrehajtott AJAX-kéréseket. Ezek a kérések további sorokként jelennek meg a Tracy sávban, lehetővé téve az egyszerű és kényelmes AJAX hibakeresést.

Ha nem szeretné automatikusan rögzíteni az AJAX-kéréseket, akkor a JavaScript változó beállításával kikapcsolhatja ezt a funkciót:

```js
window.TracyAutoRefresh = false;
```

A konkrét AJAX-kérések kézi megfigyeléséhez adja hozzá a `X-Tracy-Ajax` HTTP-fejlécet a `Tracy.getAjaxHeader()` által visszaadott értékkel. Íme egy példa a `fetch` függvénnyel való használatára:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Ez a megközelítés lehetővé teszi az AJAX-kérések szelektív hibakeresését.


Adattárolás .[#toc-data-storage]
================================

A Tracy képes megjeleníteni a Tracy bárpaneleket és a Bluescreeneket az AJAX-kérésekhez és átirányításokhoz. A Tracy saját munkameneteket hoz létre, az adatokat saját ideiglenes fájljaiban tárolja, és a `tracy-session` cookie-t használja.

A Tracy úgy is beállítható, hogy natív PHP munkamenetet használjon, amely a Tracy bekapcsolása előtt indul el:

Expand Down
31 changes: 28 additions & 3 deletions tracy/it/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ La soluzione è inserire `<?php Tracy\Debugger::renderLoader() ?>` nel template
```


AJAX e richieste reindirizzate .[#toc-ajax-and-redirected-requests]
===================================================================
Debug delle richieste AJAX .[#toc-debugging-ajax-requests]
==========================================================

Tracy cattura automaticamente le richieste AJAX effettuate con jQuery o con l'API nativa `fetch`. Queste richieste vengono visualizzate come righe aggiuntive nella barra di Tracy, consentendo un debug AJAX facile e conveniente.

Se non si desidera catturare automaticamente le richieste AJAX, è possibile disabilitare questa funzione impostando la variabile JavaScript:

```js
window.TracyAutoRefresh = false;
```

Per il monitoraggio manuale di specifiche richieste AJAX, aggiungete l'intestazione HTTP `X-Tracy-Ajax` con il valore restituito da `Tracy.getAjaxHeader()`. Ecco un esempio di utilizzo con la funzione `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Questo approccio consente un debug selettivo delle richieste AJAX.


Memorizzazione dei dati .[#toc-data-storage]
============================================

Tracy può visualizzare la barra di Debug e le Bluescreen per le richieste AJAX e di reindirizzamento. Tracy crea le proprie sessioni, memorizza i dati nei propri file temporanei e utilizza un cookie `tracy-session`.
Tracy può visualizzare pannelli a barre e Bluescreen per le richieste AJAX e i reindirizzamenti. Tracy crea le proprie sessioni, memorizza i dati nei propri file temporanei e utilizza il cookie `tracy-session`.

Tracy può anche essere configurato per utilizzare una sessione PHP nativa, che viene avviata prima dell'attivazione di Tracy:

Expand Down
31 changes: 28 additions & 3 deletions tracy/pl/recipes.texy
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,35 @@ Rozwiązaniem jest umieszczenie `<?php Tracy\Debugger::renderLoader() ?>` w swoi
```


AJAX i przekierowane żądania .[#toc-ajax-and-redirected-requests]
=================================================================
Debugowanie żądań AJAX .[#toc-debugging-ajax-requests]
======================================================

Tracy może wyświetlać pasek Debug i Bluescreens dla żądań AJAX i przekierowań. Tracy tworzy własne sesje, przechowuje dane we własnych plikach tymczasowych i używa pliku cookie `tracy-session`.
Tracy automatycznie przechwytuje żądania AJAX wykonane przy użyciu jQuery lub natywnego interfejsu API `fetch`. Żądania te są wyświetlane jako dodatkowe wiersze na pasku Tracy, umożliwiając łatwe i wygodne debugowanie AJAX.

Jeśli nie chcesz automatycznie przechwytywać żądań AJAX, możesz wyłączyć tę funkcję, ustawiając zmienną JavaScript:

```js
window.TracyAutoRefresh = false;
```

W celu ręcznego monitorowania określonych żądań AJAX, dodaj nagłówek HTTP `X-Tracy-Ajax` z wartością zwracaną przez `Tracy.getAjaxHeader()`. Oto przykład użycia go z funkcją `fetch`:

```js
fetch(url, {
headers: {
'X-Requested-With': 'XMLHttpRequest',
'X-Tracy-Ajax': Tracy.getAjaxHeader(),
}
})
```

Takie podejście pozwala na selektywne debugowanie żądań AJAX.


Przechowywanie danych .[#toc-data-storage]
==========================================

Tracy może wyświetlać panele paska Tracy i ekrany Bluescreens dla żądań AJAX i przekierowań. Tracy tworzy własne sesje, przechowuje dane we własnych plikach tymczasowych i używa pliku cookie `tracy-session`.

Tracy może być również skonfigurowany do korzystania z natywnej sesji PHP, która jest uruchamiana przed włączeniem Tracy:

Expand Down

0 comments on commit c63c266

Please sign in to comment.