device descriptors

docs/api.md

@@ -3510,10 +3510,10 @@ ResourceType will be one of the following: `document`, `stylesheet`, `image`, `m
 <!-- GEN:stop -->
 
 #### response.buffer()
-- returns: <Promise<[Buffer]>> Promise which resolves to a buffer with response body.
+- returns: <[Promise]<[Buffer]>> Promise which resolves to a buffer with response body.
 
 #### response.finished()
-- returns: <Promise[?string]> Waits for this response to finish, throws when corresponding request failed.
+- returns: <[Promise]<?[string]>> Waits for this response to finish, throws when corresponding request failed.
 
 #### response.frame()
 - returns: <[Frame]> A [Frame] that initiated this response.

index.d.ts

@@ -22,3 +22,4 @@ export const chromium: types.BrowserType<types.ChromiumBrowser>;
 export const firefox: types.BrowserType<types.FirefoxBrowser>;
 export const errors: types.BrowserTypeErrors;
 export const selectors: types.Selectors;
+export const devices: types.Devices;

utils/generate_types/overrides.d.ts

@@ -19,8 +19,8 @@ import { EventEmitter } from 'events';
 /**
  * Can be converted to JSON
  */
-interface Serializable {}
-interface ConnectionTransport {}
+type Serializable = {}
+type ConnectionTransport = {}
 
 type Boxed<Args extends any[]> = { [Index in keyof Args]: Args[Index] | JSHandle<Args[Index]> };
 type PageFunction<Args extends any[], R = any> = string | ((...args: Args) => R | Promise<R>);
@@ -125,4 +125,6 @@ export interface ChromiumSession {
     method: T,
     params?: Protocol.CommandParameters[T]
   ): Promise<Protocol.CommandReturnValues[T]>;
-}
+}
+
+export type Devices = {[name: string]: {viewport: BrowserNewContextOptionsViewport, userAgent: string}};

utils/generate_types/test/test.ts

@@ -518,6 +518,7 @@ playwright.chromium.launch().then(async browser => {
 (async () => {
   playwright.chromium.connect;
   playwright.errors.TimeoutError;
+  const iPhone = playwright.devices['iPhone'];
 
   // Must be a function that evaluates to a selector engine instance.
   const createTagNameEngine = () => ({