EyeDropper
Lets the person pick a colour from anywhere on screen.
In one line
Can pick one color from anywhere on your screen when you click
Lets the person pick a colour from anywhere on screen.
Returns one pixel colour the person points at, including outside the page. Cannot capture other pixels.
What it can and can't do
What the user does: You tap Pick color and click a spot on the screen.
It can
- Show a magnifier so you can choose a color
- Get the color code of the one spot you click
- Work on any part of the screen, even outside the page
It cannot
- Take a screenshot or see anything but the color you click
- Pick without you clicking; Esc cancels it
- Keep picking after you click once
- Work in Firefox, Safari, or on phones
How it differs between platforms: Only desktop Chrome and Edge support it. Firefox, Safari and phone browsers do not.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 95 | 2021-10-19 | Before Chrome 120, the EyeDropper API is not available on ChromeOS. See <a href="https://crbug.com/40720753">bug 40720753</a>. Available on Linux X11, but not a |
| Edge | Supported | 95 | 2021-10-21 | Before Edge 120, the EyeDropper API is not available on ChromeOS. See <a href="https://crbug.com/40720753">bug 40720753</a>. Available on Linux X11, but not ava |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Not supported | Not available | Not listed | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | new EyeDropper().open() resolves {sRGBHex} |
| Browser compat keys | api.EyeDropper |
| How access is granted | picker |
| What the user sees | Magnifier cursor over the screen; Esc cancels |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Per origin |
| How to take it back | Site settings |
| Inside an iframe | Same as top level; cross-origin iframes need a permissions policy where listed |
Typical flow
- Call the API
- Browser applies its access rules
- Page receives the result
Data you get
What comes back: Lets the person pick a colour from anywhere on screen.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
sRGBHex | string | None | #000000 to #ffffff | 24 bit colour |
Technical limits
- One pixel per call
- Needs gesture
- Desktop Chrome and Edge only
The story
What it is
A site can let you pick a colour from anywhere on your screen.
For you
You click a pipette tool and your cursor turns into a magnifier. You click and the page learns only that one colour.
For makers
Makers can add a colour picker to design tools without extra apps. The page gets one value at a time and only after you click, so it cannot read your screen.
Where you see it
| Type | Example | Apps |
|---|---|---|
| creative | A web design tool lets you grab a colour from a photo on another window. | Figma, Canva |
| productivity | A slide tool matches a chart colour to your logo. | Google Slides |
| developer | A developer tool copies a colour from any site into code. | Chrome DevTools |
| shopping | A makeup site lets you match a shade from a picture. | None named |
| education | A drawing lesson lets kids sample colours from art. | None named |
| games | A browser pixel art maker picks colours from a reference image. | Pixilart |
Risks
- Low risk
- Chrome only
What the platform says
- Google: EyeDropper API. Chrome's blog says the API lets users sample a colour from anywhere on the screen.
Good uses and abuse
Legitimate uses
- Design tools
- Colour pickers
Known abuse
- None; one pixel only
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 1 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2021-09, Chrome 95: EyeDropper ships
Sources
How well checked: Checked against real behavior.