back

Category: Browser Control

Namespace: web.browser.back

Description

Navigate back to the previous page in browser history. This is equivalent to clicking the browser back button.

Syntax

await web.browser.back();

Parameters

None

Returns

Promise<boolean> - Returns true when operation completes

Example

Simple example

await web.browser.back();

Practical example

document.getElementById('back-btn').addEventListener('click', async () => {
    const canGoBack = await web.browser.canGoBack();
    if (canGoBack) {
        await web.browser.back();
    }
});

Advanced example

async function navigateBack() {
    const canGoBack = await web.browser.canGoBack();
    
    if (canGoBack) {
        await web.browser.back();
        const url = await web.browser.getCurrentUrl();
        console.log('Navigated back to:', url);
    } else {
        console.log('Cannot go back - at start of history');
    }
}

Use Cases

• Implement back button in custom navigation
• Navigate to previous page
• Undo navigation actions
• Browser-like back functionality
• Navigate through history
• Return to previous content
• Implement keyboard shortcuts (Alt+Left)
• Custom navigation controls

Related Methods

• web.browser.forward()
• web.browser.canGoBack()
• web.browser.navigate()

Notes

• Part of browser control functionality
• Asynchronous operation
• Returns promise