seer v4.1.0

Seer API

This library provides an abstraction around the Window.postMessage API to interact with the Seer extension. You could use this module if you have a framework or application that wants to display debugging information in the Seer Chrome extension.

Install

Simply download the package from the npm registry

yarn add seer

Notes

The extension will declare a __SEER_INITIALIZED__ boolean on the window, that you can use to check if the extension is installed and prevent any useless processing in production or for real-users.

Internal

How the communication is done exactly relies on the bridge, that you can checkout in its dedicated directory. The following schema represent the complete data flow:

Functions

isReady() ⇒ Boolean

Ready check for Seer initialization

Kind: global function

throttle(key, delay) ⇒ Boolean

Utility method allowing to throttle a user action based on a key and a minimun delay.

Kind: global function

send(type, payload)

Low-level api leveraging window.postMessage

Kind: global function

init()

Initilize window listener. There will be only one for the whole process to prevent too many registrations.

This method will be called automatically if you use the listenFor method.

Kind: global function

clean()

Clean listener. Can be useful in case you want to unregister upcoming events or liberate memory.

Kind: global function

listenFor(key, cb)

Create a listener that will be called upon events of the given key.

Kind: global function

removeListener(cb)

Remove an identity listener

Kind: global function

list(key, data)

Creates a new indexed list. It works by index to get O(1) accessing and performance.

Kind: global function

listItem(key, itemKey, data)

Creates an element in the indexed list, based on the itemKey.

Kind: global function

updateItem(key, itemKey, path, data)

Update an item property, can be deeply nested.

Kind: global function

multiUpdate(key, itemKey, array)

Similar to updateItem, but allows to pass an array with {path,data} pairs for multiple update of the same item without having to send multiple messages.

Kind: global function

deleteItem(key, itemKey)

Remove a specific item in a specific tab.

Kind: global function

addLog(key, itemKey, msg)

Will create a log message to an item, that will be displayde with the current time.

Kind: global function