Dépanner les avertissements de copie et de handoff
Récupérez d’un échec de presse-papiers, de helper, de screenshot ou de visualiseur sans perdre les annotations.
5 minDans ce guide
Récupération du presse-papiers
Pinar utilise d’abord l’API presse-papiers du navigateur via un document offscreen, puis se rabat sur une sélection de texte cachée lorsque la permission ou le focus le bloque. Si tous les mécanismes de copie échouent, l’overlay est restauré afin que vos pins et commentaires restent modifiables.
Dégradé ne veut pas dire non corrélé
screenshot_missing signifie que l’image n’a pas pu être persistée. helper_unavailable signifie que le service local n’a pas été joint. viewer_unavailable signifie qu’aucune URL de visualiseur n’a été produite. Continuez à partir du commentaire, du chemin DOM, du sélecteur, des coordonnées de pin, de captureId et de pinId, puis ne réessayez que la couche manquante.
Parcourir le chemin de copie lorsque la barre d’outils signale un échec
La copie exige un commentaire enregistré et au moins un pin. La barre d’outils affiche « Enregistrement des annotations… », masque les overlays, capture le cliché, puis demande au document offscreen d’écrire text/html et text/plain. Offscreen essaie d’abord navigator.clipboard.write puis se rabat sur un événement copy plus execCommand. Si cette écriture n’est pas ok, le content script tente encore writePlainText sur la charge plain renvoyée : clipboard.writeText, puis une sélection textarea cachée.
Lorsque tous les chemins de copie échouent, la page envoie overlays:hidden avec hidden false, affiche brièvement « Échec de la copie », et laisse les pins modifiables. Une copie réussie affiche « Copié avec succès ! », ou « Copié avec succès ! » plus « pas de capture », « assistant indisponible » ou « pas de visionneuse », puis termine la session. Ces suffixes correspondent à screenshot_missing, helper_unavailable et viewer_unavailable. screenshot_inline n’est pas l’un des avertissements de handoff dégradé. Un collage sans clôture pinar-visual-context fermée ne peut pas être analysé comme JSON.
- Si la barre d’outils indique « Écrivez un commentaire » ou « Ajoutez une épingle », terminez ce pin et appuyez à nouveau sur
Command/Ctrl/Alt+Enter. - Si « Échec de la copie » apparaît, confirmez que les pins sont encore sur la page, accordez la permission du presse-papiers si elle est demandée, et réessayez la copie.
- Lisez le suffixe « Copié avec succès ! » : « pas de capture », « assistant indisponible » et « pas de visionneuse » nomment la couche manquante à réessayer sans jeter les commentaires.