Comment capturer une erreur AJAX dans un site WordPress ?

Pour capturer une erreur AJAX dans WordPress, vous devez configurer le code JavaScript côté client pour gérer les réponses d’erreur, ainsi que définir un traitement approprié côté serveur pour retourner des réponses d’erreur en cas de problème.

Voici comment vous pouvez le faire :

1. Côté client (JavaScript) :

Lorsque vous effectuez une requête AJAX en utilisant jQuery.ajax() ou jQuery.post(), vous pouvez capturer les erreurs en utilisant le callback error ou fail. Voici un exemple avec jQuery :

jQuery.ajax({
url: ajaxurl, // ou une URL spécifique
type: ‘POST’,
data: {
action: ‘my_ajax_action’, // action WordPress
data: ‘some_data’
},
success: function(response) {
// Traitement en cas de succès
console.log(‘Réponse réussie:’, response);
},
error: function(jqXHR, textStatus, errorThrown) {
// Capture et gestion des erreurs AJAX
console.error(‘Erreur AJAX:’, textStatus, errorThrown);
}
});

Dans cet exemple :

jqXHR est l’objet XMLHttpRequest qui contient les détails de la requête.

textStatus est un texte décrivant l’état de l’erreur (ex : « timeout », « error », « abort »).

errorThrown est l’exception capturée, le cas échéant.

2. Côté serveur (PHP dans WordPress) :

Assurez-vous que votre action AJAX retourne une réponse correcte en cas de succès, et une réponse avec une erreur s’il y a un problème. Voici un exemple de fonction PHP pour l’action AJAX :

add_action(‘wp_ajax_my_ajax_action’, ‘my_ajax_action_callback’);
add_action(‘wp_ajax_nopriv_my_ajax_action’, ‘my_ajax_action_callback’); // Pour les utilisateurs non connectés

function my_ajax_action_callback() {
// Vérifier la sécurité, les permissions, etc.
if (!isset($_POST[‘data’]) || empty($_POST[‘data’])) {
wp_send_json_error(‘Données manquantes’, 400); // Retourne une erreur 400 (Bad Request)
}

// Traitement de la requête AJAX
$result = process_my_data($_POST[‘data’]);

if ($result) {
wp_send_json_success($result); // Retourne une réponse de succès
} else {
wp_send_json_error(‘Erreur lors du traitement des données’, 500); // Retourne une erreur 500 (Erreur interne serveur)
}
}

function process_my_data($data) {
// Logique de traitement ici
return true; // Simule un succès
}

Détails :

wp_send_json_success($data) : envoie une réponse JSON avec un statut de succès (success: true).

wp_send_json_error($message, $status_code) : envoie une réponse JSON avec un statut d’erreur (success: false) et un code d’erreur HTTP.

Ainsi, côté client, si la requête échoue ou retourne une réponse d’erreur, vous pourrez la capturer et gérer le cas en conséquence.

Bonus : Utiliser .fail() avec jQuery.post()

Si vous préférez utiliser la fonction plus simple jQuery.post(), vous pouvez également gérer les erreurs ainsi :

jQuery.post(ajaxurl, {
action: ‘my_ajax_action’,
data: ‘some_data’
})
.done(function(response) {
// En cas de succès
console.log(‘Succès:’, response);
})
.fail(function(jqXHR, textStatus, errorThrown) {
// En cas d’erreur
console.error(‘Erreur AJAX:’, textStatus, errorThrown);
});

En résumé, la clé est d’utiliser les callbacks d’erreur en JavaScript et de structurer correctement les réponses côté serveur.