Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

feat(chromium): add local-fonts API permission (#36186)

Max Schmittbf3101f455b6
diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.md
index f9dda43e11..375b6a48b5 100644
--- a/docs/src/api/class-browsercontext.md
+++ b/docs/src/api/class-browsercontext.md
@@ -987,6 +987,7 @@ Here are some permissions that may be supported by some browsers:
* `'notifications'`
* `'payment-handler'`
* `'storage-access'`
+* `'local-fonts'`
### option: BrowserContext.grantPermissions.origin
* since: v1.8
diff --git a/packages/playwright-client/types/types.d.ts b/packages/playwright-client/types/types.d.ts
index dbd022dcc3..f788301765 100644
--- a/packages/playwright-client/types/types.d.ts
+++ b/packages/playwright-client/types/types.d.ts
@@ -8993,6 +8993,7 @@ export interface BrowserContext {
* - `'notifications'`
* - `'payment-handler'`
* - `'storage-access'`
+ * - `'local-fonts'`
* @param options
*/
grantPermissions(permissions: ReadonlyArray<string>, options?: {
diff --git a/packages/playwright-core/src/server/chromium/crBrowser.ts b/packages/playwright-core/src/server/chromium/crBrowser.ts
index 005c422812..0c640c9879 100644
--- a/packages/playwright-core/src/server/chromium/crBrowser.ts
+++ b/packages/playwright-core/src/server/chromium/crBrowser.ts
@@ -455,6 +455,7 @@ export class CRBrowserContext extends BrowserContext {
// chrome-specific permissions we have.
['midi-sysex', 'midiSysex'],
['storage-access', 'storageAccess'],
+ ['local-fonts', 'localFonts'],
]);
const filtered = permissions.map(permission => {
const protocolPermission = webPermissionToProtocol.get(permission);
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index dbd022dcc3..f788301765 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -8993,6 +8993,7 @@ export interface BrowserContext {
* - `'notifications'`
* - `'payment-handler'`
* - `'storage-access'`
+ * - `'local-fonts'`
* @param options
*/
grantPermissions(permissions: ReadonlyArray<string>, options?: {
diff --git a/tests/library/permissions.spec.ts b/tests/library/permissions.spec.ts
index 0f1f5cd0f5..cd2ab184b1 100644
--- a/tests/library/permissions.spec.ts
+++ b/tests/library/permissions.spec.ts
@@ -236,3 +236,19 @@ it('storage access', {
expect(access).toBe(true);
expect(await frame.evaluate(() => document.hasStorageAccess())).toBe(true);
});
+
+it.describe(() => {
+ // Secure context
+ it.use({ ignoreHTTPSErrors: true, });
+
+ it('should be able to use the local-fonts API', async ({ page, context, httpsServer, browserName }) => {
+ it.skip(browserName !== 'chromium', 'chromium-only api');
+ it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/36113' });
+
+ await page.goto(httpsServer.EMPTY_PAGE);
+ expect(await getPermission(page, 'local-fonts')).toBe('prompt');
+ await context.grantPermissions(['local-fonts']);
+ expect(await getPermission(page, 'local-fonts')).toBe('granted');
+ expect(await page.evaluate(async () => (await (window as any).queryLocalFonts()).length > 0)).toBe(true);
+ });
+});