WebExeBuilder Documentation

stop

Category: Browser Control

Namespace: web.browser.stop

Description

Stop loading the current page. This cancels any ongoing page load or navigation.

Syntax

await web.browser.stop();

Parameters

None

Returns

Promise<boolean> - Returns true when operation completes

Example

Simple example

await web.browser.stop();

Practical example

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

Advanced example

async function cancelNavigation() {
    console.log('Stopping page load...');
    await web.browser.stop();
    
    const url = await web.browser.getCurrentUrl();
    console.log('Stopped at:', url);
}

Use Cases

  • Cancel slow page loads
  • Stop navigation in progress
  • Implement stop button
  • Cancel unwanted navigation
  • Stop loading resources
  • Interrupt page loading
  • Implement keyboard shortcuts (Esc)
  • Cancel failed loads
  • web.browser.navigate()
  • web.browser.reload()

Notes

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