Community Toolbar

Conduit API

Case Study

EBTabRestored

This event is called right after the Firefox browser has restored after unexpected crash. This way apps can be notified on the event of a Firefox crash and act accordingly.

*Note: the function will be called once for every tab that was opened before the crash, each time with its corresponding URL and always with the same selected tab’s URL.

- Syntax

EBTabRestored(restoredTabUrl, selectedTabUrl)

- Parameters

Parameter	Description	Range	Type
restoredTabUrl	The URL of each browser tab before the crash		string
selectedTabUrl	The URL of the active (focused) tab in the browser before the crash		string

- Return Value

None.

- Remarks

This function can be used only with the HTML app.
This function is only supported with the Firefox browser.
*Notice: API methods must be invoked after the web page has triggered the "onload" event.

- Code Example

This example is an HTML app demonstrating how to receive events after Firefox has crashed and recovered. In order to simulate crash: 
Open Firefox and browse to 3 web sites (in 3 different tabs, one tab in focus is “selected”)
End the firefox.exe process from the Task Manager.
Re-open Firefox
Wait until Firefox restores all the tabs that were previously open

Now you should get 3 events, one for each restored tab, with the URL of the web sites browsed, and the URL of the tab that was selected (same URL in all 3 messages).

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<style type= "text/css">
		BODY {
			margin-left:0;
			margin-right:0;
			margin-top:0;
			margin-bottom:0;
			width:100%;
			height:100%;
			overflow:hidden;
			background-color:threedface; }
		<style></style>
			<!-- Conduit API script declaration -->
		<script type="text/javascript" language="javascript" src="http://www.conduit.com/Api/BrowserCompApi.js"></script>
		<script type="text/javascript">
		    function EBTabRestored(restoredTabUrl, selectedTabUrl) {
		        alert("Event Recieved: \nRestored tab: " + restoredTabUrl + ", \nSelected tab: " + selectedTabUrl);
		    }
            
		</script>
		<title>Browser’s Tab restoring event</title>
	</head>
	<body>
	    <label id="Label1" style="background-color:white;">Get alert after tab restored</label>
	</body>
</html>

- Code Usage