loop()

Create a new event loop for running async nodriver code

Overview

The loop() function creates and sets a new asyncio event loop. This is a convenience function for running nodriver’s async functions in a synchronous context.

Signature

def loop() -> asyncio.AbstractEventLoop

Returns

event_loop · asyncio.AbstractEventLoop

A new asyncio event loop that you can use to run async functions.

Examples

Basic usage

import nodriver as uc

async def main():
    browser = await uc.start()
    tab = await browser.get('https://example.com')
    browser.stop()

if __name__ == '__main__':
    # Create event loop and run async function
    uc.loop().run_until_complete(main())

Running multiple coroutines

import nodriver as uc
import asyncio

async def scrape_site(url):
    browser = await uc.start()
    tab = await browser.get(url)
    content = await tab.get_content()
    browser.stop()
    return content

async def main():
    urls = [
        'https://example.com',
        'https://example.org',
        'https://example.net'
    ]
    
    # Run multiple scraping tasks concurrently
    results = await asyncio.gather(
        *[scrape_site(url) for url in urls]
    )
    return results

if __name__ == '__main__':
    results = uc.loop().run_until_complete(main())
    print(results)

Alternative: Using asyncio directly

You can also use Python’s built-in asyncio.run() (Python 3.7+):

import nodriver as uc
import asyncio

async def main():
    browser = await uc.start()
    tab = await browser.get('https://example.com')
    browser.stop()

if __name__ == '__main__':
    # Alternative to uc.loop().run_until_complete()
    asyncio.run(main())

Notes

The loop() function is a convenience wrapper around asyncio.new_event_loop() and asyncio.set_event_loop().

In Python 3.7+, you can use asyncio.run() instead of uc.loop().run_until_complete() for simpler code.

See also

• start() - Launch a browser instance
• Python asyncio documentation - Learn more about async programming