> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Dépannage du SDK Web
> Dépannez les problèmes de Web Push OneSignal sur Chrome, Firefox, Safari et Android. Corrigez les erreurs courantes de service worker, d'origine, de type MIME et de push mobile avec des conseils de débogage étape par étape.
## Aperçu
OneSignal fournit des messages d'erreur détaillés dans la **Console des outils de développement** de votre navigateur lorsque votre site a le SDK Web actif.
Avant le dépannage, vérifiez la [Configuration du SDK Web](./web-sdk-setup) pour vous assurer que :
* L'extrait JavaScript OneSignal est placé dans le `` de votre site.
* Les fichiers service worker sont correctement placés à la racine et accessibles via HTTPS.
Suivez les étapes ci-dessous pour déboguer les problèmes courants et vérifier que votre intégration fonctionne correctement.
***
## Étapes initiales de dépannage
Ouvrez votre site web dans un nouveau profil de navigateur.
* Utilisez la dernière version de Chrome ou Firefox.
* Le push ne fonctionne **pas** en modes incognito/privé/invité.
* Consultez la [liste des navigateurs pris en charge](./web-push-setup-faq).
Lancez la Console de développement en appuyant sur F12, en faisant un clic droit et en sélectionnant "Inspecter", ou en naviguant vers Affichage > Développeur > Console JavaScript.
Essayez de vous abonner à votre site et vérifiez la Console pour les erreurs. Puis comparez l'erreur avec la liste ci-dessous pour obtenir des conseils.
***
## Messages d'erreur courants et solutions
### Erreurs de service worker (403, 404)
\[Service Worker Installation] Installing service worker failed TypeError: Failed to register a ServiceWorker for scope ('`https://www.yoursite.com/`') with script ('`https://www.yoursite.com/...`'): A bad HTTP response code (403) was received when fetching the script.
Si vous voyez des erreurs de service worker 403 ou 404, vos fichiers de service worker sont probablement bloqués, redirigés ou manquants.
* Confirmer la disponibilité du fichier
* Visitez l'URL du fichier service worker dans le navigateur. Vous pouvez trouver le chemin dans le tableau de bord OneSignal [Paramètres > Push & In-app > Web](./onesignal-service-worker).
* Exemples de chemins :
* `https://yoursite.com/OneSignalSDKWorker.js`
* `https://yoursite.com/push/onesignal/OneSignalSDKWorker.js`
* Si vous utilisez WordPress, le chemin est :
* `https://yoursite.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js`
* Si ceux-ci retournent un 403/404 ou une redirection, votre configuration push ne fonctionnera pas.
* Les noms de fichiers sont sensibles à la casse et doivent être accessibles publiquement.
Voir le [Guide de configuration du Service Worker](./onesignal-service-worker) pour confirmer la configuration correcte.
### Type MIME non pris en charge
* Votre service worker doit être servi en tant que `application/javascript`.
* Servir le fichier avec un autre type MIME (par ex. text/html) entraînera l'échec de l'enregistrement.
### Les redirections ne sont pas autorisées
* Les fichiers SDK OneSignal ne doivent pas rediriger.
* Ils doivent être hébergés sur la même origine que votre site (pas de domaines CDN ou proxy).
### La configuration Web Push ne peut être utilisée que sur l'origine de site correcte
* Votre domaine actuel ne correspond pas à l'URL du site configurée dans le tableau de bord OneSignal.
* Le protocole, le domaine et le sous-domaine doivent correspondre exactement.
### OneSignal est déjà défini
* Le SDK est initialisé plus d'une fois, souvent causé par la combinaison de la configuration du plugin WordPress avec du code manuel.
### L'option "Mon site n'est pas entièrement HTTPS" n'est plus prise en charge
Error: OneSignalSDK: The "My site is not fully HTTPS" option is no longer supported starting with version 16 (User Model) of the OneSignal SDK.
**Ce que cela signifie :** Votre tableau de bord OneSignal est configuré pour utiliser un site HTTP et vous avez probablement mis à jour pour utiliser HTTPS.
Vos utilisateurs qui se sont abonnés à votre site en utilisant HTTP ou l'option "Mon site n'est pas entièrement HTTPS" sont en fait abonnés à un sous-domaine que nous vous avons fourni au format `https://your-label.os.tc` et non à l'origine réelle de votre site. C'est parce que le web push n'est pas pris en charge sur les sites HTTP ou les sites web qui ne peuvent pas héberger de service workers.
**Comment résoudre :** Vous avez 2 options, mais les deux nécessitent que vos utilisateurs se réabonnent car ils sont en fait abonnés au sous-domaine `os.tc`.
1. Créez une nouvelle application OneSignal et définissez le nouvel ID d'application dans votre code d'initialisation OneSignal. L'avantage est que vous pouvez continuer à envoyer des push depuis l'ancienne/originale application OneSignal. Envoyez autant de notifications que vous le souhaitez pour informer vos utilisateurs que le site a été mis à jour et qu'ils doivent revenir et se réabonner pour continuer à recevoir des mises à jour. Offrir une réduction ou une incitation pour se réabonner est très efficace. Définissez l'"URL de lancement" sur une page de destination et fournissez-leur un bouton pour se réabonner facilement comme notre invite en cloche, notre invite de lien personnalisé ou notre invite de diapositives de catégorie. Consultez [Invites de permission](./permission-requests) pour plus de détails.
2. Si vous souhaitez conserver le même ID d'application, vous devrez utiliser notre API [Mettre à jour une application](/reference/update-an-app) pour mettre à jour le `chrome_web_origin` et le `safari_site_origin` vers l'origine HTTPS de votre site. Parce que ces utilisateurs se sont abonnés au sous-domaine `os.tc`, ils n'ont pas les autorisations push activées dans le navigateur pour votre site. Le navigateur ne "sait pas" qu'ils sont abonnés à votre site, donc ils seront à nouveau invités. S'ils se réabonnent, ils auront 2 abonnements web push à votre site sur le même navigateur et recevront des notifications en double. Pour cette raison, nous recommandons de [supprimer tous vos abonnés web push actuels](./delete-users) pour éviter qu'ils ne reçoivent des notifications en double. Avant de supprimer, envoyez quelques notifications pour informer vos utilisateurs que le site a été mis à jour et qu'ils doivent se réabonner pour continuer à recevoir des mises à jour. Offrir une réduction ou une incitation pour se réabonner fonctionne très bien. Définissez l'"URL de lancement" sur une page de destination et fournissez-leur un bouton pour se réabonner facilement comme notre invite en cloche, notre invite de lien personnalisé ou notre invite de diapositives de catégorie. Consultez [Invites de permission](./permission-requests) pour plus de détails.
***
## Dépannage du web push mobile
**iOS** - Voir [Safari Web Push sur iOS](./web-push-for-ios) pour les exigences.
**Android** - Le web push fonctionne automatiquement sur les appareils mobiles Android utilisant un navigateur pris en charge.
1. Assurez-vous d'abord que votre site fonctionne sur Desktop avant de tester sur mobile.
2. Vous êtes peut-être déjà abonné sur le web Android, mais notre tableau de bord ne différencie pas les abonnés web mobiles des abonnés web de bureau. Un abonné web Android s'affiche comme `Linux armv8l` dans la colonne Appareil de la page "Abonnements".
3. Vérifiez si les notifications sont activées sur l'application du navigateur. Par exemple, sur Chrome dans vos Paramètres Android > Gestionnaire d'applications > Chrome. Assurez-vous que "Afficher les notifications" est coché.
4. Effacez votre cache. Si le cache de votre navigateur est plein sur mobile, cela peut empêcher d'autres invites ou abonnements.
5. Certains utilisateurs ont signalé que la désinstallation et la réinstallation de l'application du navigateur ont résolu un problème où l'invite ne s'affichait pas.
***
## Dépannage Safari
1. L'URL du site définie dans la configuration Safari doit être exactement ce que vous voyez lorsque vous visitez le site. Par exemple, si vous voyez `https://www.yoursite.com` dans le navigateur, vous devez ajouter ceci au champ de configuration. Les sites www et non-www sont des origines différentes.
2. Safari 12.1+ a créé une nouvelle règle selon laquelle [les utilisateurs doivent effectuer une action sur le site avant de pouvoir être invités](https://developer.apple.com/documentation/safari_release_notes/safari_12_1_release_notes)
Vous devez utiliser l'[Invite coulissante](./permission-requests) sur Safari. C'est pourquoi l'invite coulissante s'affiche toujours avant la native si vous utilisez notre configuration typique.
Si vous souhaitez utiliser uniquement l'invite native du navigateur, vous devrez configurer votre propre déclencheur pour détecter une action de l'utilisateur. Ensuite, appelez nos [méthodes du SDK Web](./web-sdk-reference) pour déclencher l'invite.
3. Enfin, essayez de [Effacer votre cache et réinitialiser les autorisations push](./clearing-cache-and-resetting-push-permissions) pour voir votre site comme un utilisateur pour la première fois et essayer de vous abonner à nouveau.
### Les icônes Safari ou le nom du site ne changent pas
En raison de l'implémentation personnalisée du web push de Safari, le nom de votre site et l'image de l'icône sont traités comme des ressources statiques téléchargées et stockées localement sur l'ordinateur de l'utilisateur. Les nouveaux noms de site et les nouvelles images ne sont pas mis à jour ou téléchargés.
Malheureusement, toute personne abonnée avec ces anciennes ressources devra [effacer votre cache et réinitialiser les autorisations push](./clearing-cache-and-resetting-push-permissions) et revenir sur le site pour se réabonner.
***
## Effacer votre cache et réinitialiser les autorisations push
Voir [Effacer votre cache et réinitialiser les autorisations push](./clearing-cache-and-resetting-push-permissions) pour plus de détails.
***
## Débogage à l'aide des outils de développement du navigateur
Les outils de développement du navigateur peuvent être utilisés pour interagir avec le SDK web sur votre page web et activer la journalisation ou envoyer facilement des notifications de test à vous-même.
**Débogage sur Desktop :**
* **Chrome** : Faites un clic droit sur la page, cliquez sur *Inspecter*, et cliquez sur l'onglet *Console* de la fenêtre contextuelle qui s'ouvre.
* **Firefox** : Faites un clic droit sur la page, cliquez sur *Inspecter l'élément*, et cliquez sur l'onglet *Console* de la fenêtre contextuelle qui s'ouvre.
* **Safari** : Allez dans **Safari → Préférences → Avancé** et assurez-vous que *Afficher le menu Développement dans la barre de menus* est coché. Ensuite, sur votre page web, faites un clic droit, cliquez sur *Inspecter l'élément*, et cliquez sur l'onglet *Console* de la fenêtre contextuelle qui s'ouvre.
**Débogage sur Android :**
* **Chrome sur Android** : [Activez le débogage USB](https://developer.chrome.com/docs/devtools/remote-debugging/), connectez votre appareil à votre ordinateur et accédez aux Dev Tools avec `chrome://inspect#devices` dans votre navigateur Chrome de bureau.
* **Firefox sur Android** : [Activez le débogage USB](https://developer.mozilla.org/en-US/docs/Tools/about:debugging), connectez votre appareil à votre ordinateur et accédez aux Dev Tools avec `about:debugging` dans votre navigateur Firefox de bureau.
Vous devriez maintenant pouvoir exécuter des commandes dans la Console des outils de développement.
Exécutez le code suivant :
```
OneSignal.Debug.setLogLevel('trace');
```
Vous devriez voir `undefined` comme résultat.
Si vous voyez :
Uncaught ReferenceError: OneSignal is not defined(…) ReferenceError: OneSignal
is not defined{" "}
Alors OneSignal n'est pas actif sur votre page web, ou vous devez basculer vers le contexte de frame `top` (voir la capture d'écran ci-dessus).
Maintenant que la journalisation de débogage de notre SDK web est activée, veuillez fermer l'onglet et ouvrir un nouvel onglet sur la même page (actualiser la page ne suffit pas pour déclencher certains de nos événements SDK). Vous devriez voir beaucoup de sortie dans la Console.
Vous pouvez toujours désactiver cette journalisation supplémentaire en entrant ce code :
```
OneSignal.Debug.setLogLevel('warn');
```
Exécutez dans la Console :
```
function getUserInfo() {
console.log('getUserInfo()');
Promise.all([
OneSignal.Notifications.permission,
OneSignal.User.PushSubscription.id,
OneSignal.User.PushSubscription.token,
OneSignal.User.PushSubscription.optedIn,
OneSignal.context.serviceWorkerManager.getActiveState(),
])
.then(
([
isSubscribed,
subscriptionId,
pushToken,
optedIn,
serviceWorkerActive,
]) => {
console.log('What is the current URL of this page?', location.href);
console.log(
"Is a service worker registered and active? (should be false on Safari, otherwise should be 'OneSignal Worker')?",
serviceWorkerActive
);
console.log('')
console.log('Are you subscribed, in the browser?', isSubscribed)
console.log('Are you opted-in, in OneSignal?' , optedIn);
console.log('');
console.log('What is your OneSignal Subscription ID?', subscriptionId);
console.log('What is your Push Token?', pushToken);
}
)
.catch(e => {
console.error('Issue determining whether push is enabled:', e);
});
}
getUserInfo();
```
Selon que vous soyez abonné ou non, vous devriez voir quelque chose de similaire à ce qui suit :
```
What is the current URL of this page? http://localhost:8080/
Is a service worker registered and active? (should be false on Safari, otherwise should be 'OneSignal Worker')? OneSignal Worker
Are you subscribed, in the browser? true
Are you opted-in, in OneSignal? true
What is your OneSignal Subscription ID? 22ff6b0d-60e1-469d-b667-005274204322
What is your Push Token? https://fcm.googleapis.com/fcm/send/drKvxiBc9Eo:APA91bFoa88bzkuudYFmuyNb8uIA60dI44SnBbXi0_4GAYa2Ln07XzrOs1-k5KVxrwKf8oVxBvzIXVN-44bamCRkaQ6cFODy7-8slGgnV3i2OqS3EgYrzU6VcO1KZaBHacsZhqvWqIRv
```
*Uniquement si vous êtes abonné* (voir la section ci-dessus), vous pouvez vous envoyer une notification de test. Voir [Trouver et définir des abonnements de test](./test-users) pour plus de détails.
* Assurez-vous que vous ne bloquez pas les notifications au niveau du système d'exploitation.
* Voir [Notifications non affichées : Web Push](./notifications-not-shown-web-push).
***
## Débogage de la non-réception des notifications Chrome
**Remarque :** Veuillez suivre ces étapes dans l'ordre.
* Pour l'étape n°3, êtes-vous abonné ? Si ce n'est pas le cas, arrêtez-vous ici, [effacez complètement les données de votre site en suivant ces instructions spécifiques](./clearing-cache-and-resetting-push-permissions), puis réabonnez-vous à votre site afin de recevoir des notifications. Exécutez à nouveau l'étape n°3 pour vérifier que vous êtes réellement abonné. Lorsque vous suivez les instructions d'effacement des données du site, n'oubliez pas de fermer tous les onglets de votre site ou de redémarrer votre navigateur, car Chrome empêche l'accès au stockage du site tant que tous les onglets existants de votre site ne sont pas fermés.
* Pour l'étape n°4, recevez-vous une notification de test ? Si oui, vous avez terminé !
Si vous êtes abonné mais que vous n'avez pas reçu de notification de test, veuillez visiter la page de livraison de votre tableau de bord OneSignal pour voir si les notifications de test que vous vous êtes envoyées s'affichent en haut.
Si vous êtes abonné, que vous n'avez pas reçu de notification de test, mais que vous voyez que le message a été livré (en vert), veuillez ouvrir Chrome à `chrome://gcm-internals`.
Cliquez sur le bouton "Start Recording" en haut à gauche. Assurez-vous de voir "Connection State: CONNECTED".
Laissez cela ouvert et envoyez-vous un push (suivez l'étape n°4 ci-dessus pour vous envoyer une notification de test).
Vous devriez voir quelque chose dans le "Receive Message Log" si vous l'avez reçu.
* Si vous ne voyez pas de "Data msg received", alors votre navigateur Chrome ne reçoit pas du tout la notification. Veuillez nous en informer sur le support.
* Si vous voyez "Data msg received" mais que vous n'avez toujours pas reçu de notification, passez à l'étape n°4.
Visitez `chrome://serviceworker-internals`.
Recherchez `Scope: https://your-site.com`.
Cliquez sur *Inspect*, ou *Start -> Inspect*, comme ci-dessous. Une fenêtre contextuelle des outils de développement Chrome apparaîtra.
Dans la fenêtre contextuelle des outils de développement Chrome pour notre service worker, cliquez sur l'onglet *Console*, et exécutez `OneSignalWorker.log.trace();`. Cela devrait retourner `undefined`. Tous les messages de notre service worker devraient maintenant apparaître dans cette fenêtre contextuelle.
Revenez de la fenêtre contextuelle Dev Tools du service worker à la console des outils de développement de votre page principale (celle utilisée à l'étape 2).
Envoyez-vous une autre notification de test. Si vous ne voyez toujours pas la notification, examinez la sortie de la console pour détecter de nouvelles erreurs ou messages.
Pour partager ces informations avec le support :
* Faites un clic droit dans la Console.
* Sélectionnez Enregistrer sous ... pour exporter le fichier journal.
* Joignez ce fichier et contactez notre support par chat pour obtenir de l'aide supplémentaire.
Besoin d'aide ?
Discutez avec notre équipe d'assistance ou envoyez un e-mail à `support@onesignal.com`
Veuillez inclure :
* Les détails du problème que vous rencontrez et les étapes de reproduction si disponibles
* Votre OneSignal App ID
* L'External ID ou le Subscription ID le cas échéant
* L'URL du message que vous avez testé dans le OneSignal Dashboard le cas échéant
* Tous les [journaux ou messages d'erreur](/docs/en/capturing-a-debug-log) pertinents
Nous serons ravis de vous aider !
***