Retrieves a value previously stored by a call to sessions.setTabValue
.
You can retrieve a value from a tab even over a close/restore cycle: meaning that if you set a value, then the user closes the tab, then restores the tab using the browser's "restore tab" feature (for example, by pressing Control+Shift+T), then you will be able to retrieve the value from the restored tab. Note, though, that a restored tab does not get the same ID as the original, so the ID you pass into getTabValue()
will be different from the ID you passed into setTabValue()
, even though they both refer to the same tab.
This is an asynchronous function that returns a Promise
.