appium-remote-debugger

    8.13.2 • Public • Published

    appium-remote-debugger

    Build Status Dependency Status devDependency Status

    A Node.js frontend for the Remote Debugger protocol used by Appium to connect to iOS webviews and Safari. Written using ES6+.

    Issues for this repo are disabled. Log any issues at the main Appium repo's issue tracker.

    Safari's version of the WebKit API

    Safari implements a wonky version of the WebKit API. It is not documented. The JSON version of the protocol is documented in the WebKit source code, in Source/JavaScriptCore/inspector/protocol/.

    There is good documentation for the closely related API from Chrome DevTools, to be found here.

    API

    This is an event emitter, which emits a RemoteDebugger.EVENT_PAGE_CHANGE event when there has been a change to the page. This should be caught and handled as the calling code wishes. It also emits a RemoteDebugger.EVENT_DISCONNECT event when the server disconnects the last application connected.

    The steps to using the RemoteDebugger involve instantiating an object, then running connect and selectApp. After this the instance will be listening for events from the server (i.e., the webview or browser).

    Selenium "atoms"

    The remote debugger uses the standard Selenium Atoms to interact with web pages. These need to be manually updated when necessary. To do so, simply update the branch in the gulpfile, by modifying the SELENIUM_BRANCH constant at the top of the file. Then run npm run build:atoms, test and create a pull request with the resulting changed atoms directory.

    One caveat is that there are some changes that are needed for Appium, that are not yet in the Selenium codebase. See the atoms notes for details.

    Watch

    npm run watch
    
    gulp watch
    

    Test

    npm test
    

    Keywords

    Install

    npm i appium-remote-debugger

    DownloadsWeekly Downloads

    147,959

    Version

    8.13.2

    License

    Apache-2.0

    Unpacked Size

    1.65 MB

    Total Files

    70

    Last publish

    Collaborators

    • boneskull
    • jlipps
    • imurchie
    • dangraham
    • nick.mokhnach
    • umut.uzgur
    • kazucocoa
    • bootstraponline