Diagnostics & Logs

Trace, inspect, and debug your Remote Tab Opener workflows — no DevTools required.

Guided tests • Live RTO_RESPONSE logger • Error cookbook • QA checklist

v7.10.1

1) Overview

  • Guided Test Panel — lance detect, navigate, getCurrentUrl, getTitle et vois le résultat.
  • Inline Event Console — flux en direct des RTO_RESPONSE avec timing.
  • Error Cookbook — erreurs fréquentes et correctifs.
  • QA Checklist — petite liste de contrôle pour démarrer.

Garde cette page ouverte pendant que tu testes tes scripts d’admin.

2) Guided Test Panel

Vérifie les bases avant de chercher plus loin.
Detection
waiting

Demande à l’extension sa présence et sa version.


              

            

          


          
          

            

              

                

                  
Open / Navigate

                  waiting
                

                
Navigation sans danger (l’extension peut afficher son popup d’Allow-list).

                

                  URL
                  
                

                
                
                

                  Note : si tu obtiens DOMAIN_NOT_ALLOWED, ajoute l’hôte dans le popup de l’extension puis réessaie.
                

              

            

          


          
          

            

              

                

                  
Read URL

                  waiting
                

                
Vérifie qu’un onglet distant existe et renvoie son URL.

                
                

              

            

          


          
          

            

              

                

                  
Read Title

                  waiting
                

                
Sanity check : lit le titre du document dans l’onglet distant.

                
                

              

            

          

        


        
      


      
      

        

          
3) Inline Event Console

          

            

              
              
            

            
            
          

        


        

          Chaque RTO_REQUEST reçoit un RTO_RESPONSE avec ton 
          requestId, un booléen ok, et soit 
          data soit error.
        


        
[waiting…]

        

          Lire une ligne : [12:34:56] RTO_RESPONSE ok #r12 842ms = réponse à la requête r12 en 842ms, succès.
        


        
      


      
      

        
4) Error Cookbook (quick diagnosis)

        

          

            
              

                Code
                Symptom
                Cause
                Fix
              

            
            
              

                DOMAIN_NOT_ALLOWED
                No actions on target site
                Domain not in Allow-list (deny-by-default)
                Open popup → Add host (or wildcard) → Retry
              

              

                NO_CONTROLLED_TAB
                focus/getCurrentUrl fails
                No remote tab yet
                Call navigate() first
              

              

                INVALID_URL
                open/navigate rejected
                Malformed or forbidden scheme
                Use absolute https:// URL on a public host
              

              

                ELEMENT_NOT_FOUND
                Click/type fails
                Selector wrong or too early
                waitFor first; fix selector
              

              

                TIMEOUT
                Action never ends
                Slow SPA or missing element
                Increase timeout; add backoff; verify selector
              

              

                EXECUTION_ERROR
                runJs throws
                Bug in your snippet
                Test in page console; guard nulls
              

              

                FORBIDDEN
                Input read/write blocked
                Sensitive field protection
                Avoid secrets; redesign the flow
              

              

                EXT_NOT_DETECTED
                No response to detect
                Extension not installed or disabled
                Install/enable the extension; reload this page
              

            
          

        

      


      
      

        
5) QA Checklist

        
    
          
  • ✅ Extension detected (detect → ok visible).
    • 
          
  • ✅ Allow-list configurée (pas de DOMAIN_NOT_ALLOWED à la première navigate).
    • 
          
  • ✅ Onglet distant ouvert (RTO_RESPONSE ok après navigate).
    • 
          
  • ✅ Au moins une réponse ok:true pour une action DOM.
    • 
          
  • ✅ Tous les steps se terminent avec ok:true dans la console.
    • 
          
  • ⚠️ Si NO_CONTROLLED_TAB, recommence par navigate().
    • 
        

      


      
      

        
6) Automated Self-Check (optional)

        
Petit “health check”. Note : DOMAIN_NOT_ALLOWED est un “soft skip” (nécessite consentement utilisateur).


        

          

            

              
Quick test

              
            


            

              

                
                  
StepResultTime

                
                
              

            

          

        


        
      


      
      

        
7) Performance & tips

        
    
          
  • Regroupe les actions DOM quand c’est possible pour éviter de saturer la messagerie.
    • 
          
  • Préférez domSetValue à domType si tu n’as pas besoin d’une validation caractère par caractère.
    • 
          
  • Throttle les playlists QA (0.5–1s entre pages).
    • 
          
  • Enrobe chaque ask() avec performance.now() pour mesurer la durée.
    • 
        

      


      
      

        
        
        Need help writing safe flows?

        Try the ChatGPT helper: Remote Tab Opener Copilot.
      


      
      

        
Next Pages

        

          

            
              

                Page
                Description
              

            
            
              

                Start
                Overview, how it works, setup, quick start, and links to all sections.
              

              

                Detect the Extension
                Detection contract, install prompts, and graceful fallbacks when the extension isn’t present.
              

              

                Allow-list & Permissions
                Deny-by-default model, domain allow-list via popup, and suggested UX to guide users to enable hosts.
              

              

                LAN / Localhost
                How to safely enable intranet/localhost (flags + allow-list).
              

              

                Remote Tab Control
                Open/navigate/focus the controlled tab, read URL/title, select an existing tab, lifecycle & restore patterns.
              

              

                DOM & Automation
                Action catalog (domType, domSetValue, domClick, selectSetValue, submitForm, waitFor).
              

              

                Diagnostics
                Live RTO_RESPONSE console, error cookbook, and self-checks.
              

              

                Full API Reference
                Canonical envelopes, request/response schemas, error codes, and return shapes.
              

              

                Compatibility
                Supported browsers/versions, CSP/iframe notes, known limitations/workarounds.
              

              

                Advanced Patterns
                Idempotent flows, retries/backoff, state restore, playlist strategies, robust selectors.
              

              

                Favorites
                Star and group URLs, quick actions, export/import sets, and playlist runs from favorites.
              

              

                Real-World Flows (E2E)
                Run end-to-end flows from your admin page with best practices and troubleshooting.