> ## Documentation Index
> Fetch the complete documentation index at: https://gologin.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Headless mode

A headless browser is a web browser without a graphical user interface (GUI). It runs in the background, controlled programmatically through code or command-line interfaces. Headless browsers can perform all standard browser operations like rendering web pages, executing JavaScript, and handling cookies, but without displaying any visual components.

## Common Use Cases

* Web scraping and data extraction
* Automated testing of web applications
* Taking screenshots or generating PDFs of web pages
* Performance monitoring and testing
* Automation of repetitive web tasks

## Advantages

* Reduced resource consumption (no GUI rendering required)
* Faster execution than full browser instances
* Ideal for server environments without display capabilities
* Perfect for CI/CD pipelines and automated workflows

Headless browsers are commonly used in developer tools, testing frameworks, and automation services to interact with web content programmatically.

# Headless example

<CodeGroup tag="iphey.com" label="Check trustworthiness status">
  ```js Node.js theme={null}
  // SDK will prepare the browser and will start it on your machine then you can control it with puppeteer
  import { GologinApi } from 'gologin';

  const token = process.env.GL_API_TOKEN || 'your dev token here';
  const gologin = GologinApi({
    token,
  });

  async function main() {
    const { browser } = await gologin.launch({
      extra_params: ['--headless'],
      // pass profileId parameter if you want to run particular profile
      // profileId: 'your profileId here',
    });

    const page = await browser.newPage();

    await page.goto('https://iphey.com/', { waitUntil: 'networkidle2' });
    const status = await page.$eval('.trustworthy:not(.hide)',
      (elt) => elt?.innerText?.trim(),
    );

    await new Promise((resolve) => setTimeout(resolve, 10000));
    console.log('status', status);

    return status;
  }

  main().catch(console.error)
    .finally(gologin.exit);
  ```

  ```python Python theme={null}
  import time
  from gologin import GoLogin
  from selenium import webdriver
  from selenium.webdriver.chrome.service import Service
  from webdriver_manager.chrome import ChromeDriverManager


  # Initialize GoLogin
  gl = GoLogin({
  	"token": "your dev token",
    "extra_params": ["--headless"]
  })
  profile = gl.createProfileRandomFingerprint({ "os": "win" })
  profile_id = profile.get('id')
  gl.setProfileId(profile_id)
  # Add proxy to the profile
  gl.addGologinProxyToProfile(profile_id, "us")

  # Start Browser and get websocket url
  debugger_address = gl.start()

  # Get Chromium version for webdriver
  chromium_version = gl.get_chromium_version()


  # Install webdriver
  service = Service(ChromeDriverManager(driver_version=chromium_version).install())

  chrome_options = webdriver.ChromeOptions()
  chrome_options.add_experimental_option("debuggerAddress", debugger_address)

  driver = webdriver.Chrome(service=service, options=chrome_options)

  # Give command to Selenium to open the page
  driver.get("http://www.python.org")

  time.sleep(30)
  driver.quit()
  time.sleep(10)

  gl.delete(profile_id)

  gl.stop()

  ```
</CodeGroup>