Microsoft Edge Targets API

openapi: 3.2.0
info:
  title: Microsoft Edge DevTools Protocol HTTP Targets API
  description: HTTP endpoints for the Microsoft Edge DevTools Protocol, based on the Chromium DevTools Protocol. These endpoints allow programmatic discovery and management of debuggable browser targets including pages, service workers, and extensions. The HTTP API serves as the entry point for establishing WebSocket debugging connections to individual targets.
  version: 1.0.0
  contact:
    name: Microsoft Edge Developer
    url: https://developer.microsoft.com/microsoft-edge/
  license:
    name: Microsoft Software License
    url: https://www.microsoft.com/legal/terms-of-use
  x-generated-from: documentation
  x-last-validated: '2026-04-18'
servers:
- url: http://localhost:9222
  description: Local Edge DevTools debugging endpoint
security: []
tags:
- name: Targets
  description: Discover and manage debuggable browser targets
paths:
  /json/list:
    get:
      operationId: listTargets
      summary: Microsoft Edge List Debuggable Targets
      description: Returns a JSON array of all debuggable targets including pages, service workers, extensions, and background pages with their WebSocket debugger URLs.
      tags:
      - Targets
      responses:
        '200':
          description: List of debuggable targets
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Target'
              examples:
                ListTargets200Example:
                  summary: Default listTargets 200 response
                  x-microcks-default: true
                  value:
                  - description: ''
                    devtoolsFrontendUrl: /devtools/inspector.html?ws=localhost:9222/devtools/page/ABC123
                    id: ABC123
                    title: Example Page
                    type: page
                    url: https://www.example.com
                    webSocketDebuggerUrl: ws://localhost:9222/devtools/page/ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    Target:
      type: object
      description: A debuggable browser target
      properties:
        description:
          type: string
          description: Target description
          example: ''
        devtoolsFrontendUrl:
          type: string
          description: URL to the DevTools frontend for this target
          example: /devtools/inspector.html?ws=localhost:9222/devtools/page/ABC123
        faviconUrl:
          type: string
          description: URL to the target's favicon
          example: https://www.example.com/favicon.ico
        id:
          type: string
          description: Unique target identifier
          example: ABC123
        title:
          type: string
          description: Page title
          example: Example Page
        type:
          type: string
          description: Target type
          enum:
          - page
          - background_page
          - service_worker
          - worker
          - iframe
          - other
          example: page
        url:
          type: string
          format: uri
          description: Current URL of the target
          example: https://www.example.com
        webSocketDebuggerUrl:
          type: string
          description: WebSocket URL for debugging this target
          example: ws://localhost:9222/devtools/page/ABC123