Implementation:SeleniumHQ Selenium ChromiumDriverLogLevel

Knowledge Sources	SeleniumHQ_Selenium Selenium Documentation
Domains	WebDriver, Chromium_Browser
Last Updated	2026-02-12 00:00 GMT

Overview

ChromiumDriverLogLevel is a Java enum that defines the logging verbosity levels recognized by ChromeDriver, mapping them to standard java.util.logging.Level values.

Description

The ChromiumDriverLogLevel enum provides six log level constants -- ALL, INFO, DEBUG, WARNING, SEVERE, and OFF -- mirroring the levels defined in the Chromium ChromeDriver source. It includes an internal mapping from java.util.logging.Level to ChromiumDriver-specific levels, along with utility methods for case-insensitive string conversion (fromString) and java.util.logging.Level conversion (fromLevel). The toString() override returns the level name in lowercase English, matching the wire format expected by ChromeDriver.

Usage

Use ChromiumDriverLogLevel when configuring the logging verbosity of a ChromeDriver or EdgeDriver session. It is typically passed into Chromium-based options or service builder classes to control the amount of diagnostic output produced by the browser driver process.

Code Reference

Source Location

• Repository: SeleniumHQ_Selenium
• File: java/src/org/openqa/selenium/chromium/ChromiumDriverLogLevel.java

Signature

public enum ChromiumDriverLogLevel {
    ALL,
    INFO,
    DEBUG,
    WARNING,
    SEVERE,
    OFF;

    @Override
    public String toString();

    @Nullable
    public static ChromiumDriverLogLevel fromString(String text);

    public static ChromiumDriverLogLevel fromLevel(Level level);
}

Import

import org.openqa.selenium.chromium.ChromiumDriverLogLevel;

I/O Contract

Enum Constants

Constant	Description	Mapped java.util.logging.Level(s)
ALL	Log everything	Level.ALL (and default fallback)
INFO	Informational messages	Level.INFO
DEBUG	Debug-level messages	Level.FINEST, Level.FINER, Level.FINE
WARNING	Warning messages	Level.WARNING
SEVERE	Severe/error messages	Level.SEVERE
OFF	Disable logging	Level.OFF

Methods

Method	Parameters	Return Type	Description
toString()	none	String	Returns the level name in lowercase English (e.g., "debug").
fromString(String text)	text -- case-insensitive level name	ChromiumDriverLogLevel or null	Parses a string to the matching enum value. Returns null if no match or if text is null.
fromLevel(Level level)	level -- a java.util.logging.Level	ChromiumDriverLogLevel	Converts a standard Java logging level to the corresponding ChromiumDriver level. Defaults to ALL if no mapping exists.

Usage Examples

// Convert from a string
ChromiumDriverLogLevel level = ChromiumDriverLogLevel.fromString("debug");
// level == ChromiumDriverLogLevel.DEBUG

// Convert from a java.util.logging.Level
ChromiumDriverLogLevel fromJul = ChromiumDriverLogLevel.fromLevel(Level.WARNING);
// fromJul == ChromiumDriverLogLevel.WARNING

// Use toString() for the wire format
String wireValue = ChromiumDriverLogLevel.SEVERE.toString();
// wireValue == "severe"

// Configure ChromeDriver service logging
ChromeDriverService service = new ChromeDriverService.Builder()
    .withLogLevel(ChromiumDriverLogLevel.DEBUG)
    .build();

Related Pages

• SeleniumHQ_Selenium_ChromiumNetworkConditions -- Network condition simulation for Chromium browsers
• SeleniumHQ_Selenium_HasCdp -- Interface for executing Chrome DevTools Protocol commands
• Selenium Chrome Documentation
• ChromeDriver Logging Source