system.display

This is useful for extensions that manage windows or need to adapt their UI based on the user's screen setup.

Examples:

• A window management extension that can snap windows to specific displays.
• A presentation tool that needs to know the resolution of the external monitor.
• A screenshot tool that allows the user to capture a specific screen.

{
  "name": "My Display Info Extension",
  "version": "1.0",
  "manifest_version": 3,
  "permissions": [
    "system.display"
  ]
}

Why is it not very risky?

This permission lets an extension see information about your monitor(s), like their size and resolution.

This is a low-risk permission. It does not allow the extension to see what is on your screen, only the technical details about the screen itself. The main minor risk is that this information can be used by websites to help identify your specific computer (a technique called "fingerprinting"), but for most users, this is not a significant concern.

This example gets information about all connected displays and logs it.

// background.js or popup.js

async function getDisplayInfo() {
  if (!chrome.system.display) {
    console.log('System Display API not available.');
    return;
  }
  try {
    const displays = await chrome.system.display.getInfo();
    if (displays.length > 0) {
      console.log(`Found ${displays.length} display(s):`);
      displays.forEach((display, i) => {
        console.log(`  Display ${i+1}:`);
        console.log(`    Resolution: ${display.bounds.width}x${display.bounds.height}`);
        console.log(`    Is Primary: ${display.isPrimary}`);
      });
    } else {
      console.log('No displays found.');
    }
  } catch (error) {
    console.error('Error getting display info:', error);
  }
}

// Listen for when the display configuration changes
chrome.system.display.onDisplayChanged.addListener(() => {
  console.log('Display configuration changed. Refetching info...');
  getDisplayInfo();
});


getDisplayInfo();