Puppeteer 中文文档v25.8.0

Docs Puppeteer API @puppeteer/browsers API

connect defaultArgs defaultBrowser executablePath lastLaunchedBrowser launch setFollowSymlinks trimCache

clearCustomQueryHandlers connect customQueryHandlerNames registerCustomQueryHandler unregisterCustomQueryHandler

[asyncDisposeSymbol] [disposeSymbol] addScreen browserContexts close cookies createBrowserContext defaultBrowserContext deleteCookie deleteMatchingCookies disconnect extensions getPWAState getWindowBounds installExtension installPWA launchPWA newPage pages process removeScreen screens setCookie setPermission setWindowBounds target targets uninstallExtension uninstallPWA userAgent version waitForTarget wsEndpoint

[asyncDisposeSymbol] [disposeSymbol] browser clearPermissionOverrides close cookies deleteCookie deleteMatchingCookies newPage overridePermissions pages setCookie setPermission targets waitForTarget

[asyncDisposeSymbol] [disposeSymbol] $ $$ $$eval $eval addScriptTag addStyleTag authenticate bringToFront browser browserContext captureHeapSnapshot click close content cookies createCDPSession createPDFStream deleteCookie emulate emulateCPUThrottling emulateFocusedPage emulateIdleState emulateLocale emulateMediaFeatures emulateMediaType emulateNetworkConditions emulateTimezone emulateVisionDeficiency evaluate evaluateHandle evaluateOnNewDocument exposeFunction extensionRealms focus frames getDefaultNavigationTimeout getDefaultTimeout goBack goForward goto hasDevTools hover isClosed isDragInterceptionEnabled isJavaScriptEnabled isServiceWorkerBypassed locator mainFrame metrics openDevTools pdf queryObjects reload removeExposedFunction removeScriptToEvaluateOnNewDocument resize screencast screenshot select setBypassCSP setBypassServiceWorker setCacheEnabled setContent setCookie setDefaultNavigationTimeout setDefaultTimeout setDragInterception setExtraHTTPHeaders setGeolocation setJavaScriptEnabled setOfflineMode setRequestInterception setUserAgent setViewport tap target title triggerExtensionAction type url viewport waitForDevicePrompt waitForFileChooser waitForFrame waitForFunction waitForNavigation waitForNetworkIdle waitForRequest waitForResponse waitForSelector windowId workers

click clone fill filter hover map race scroll setEnsureElementIsInTheViewport setTimeout setVisibility setWaitForEnabled setWaitForStableBoundingBox wait waitHandle

close evaluate evaluateHandle url waitForFunction

down press sendCharacter type up

click down drag dragAndDrop dragEnter dragOver drop move reset up wheel

tap touchEnd touchMove touchStart

accept cancel isMultiple

accept defaultValue dismiss message type

args location stackTrace text type

$ $$ $$eval $eval addScriptTag addStyleTag childFrames click content evaluate evaluateHandle extensionRealms focus frameElement goto hover isDetached locator name page parentFrame select setContent tap title type url waitForFunction waitForNavigation waitForSelector

[asyncDisposeSymbol] [disposeSymbol] asElement dispose evaluate evaluateHandle getProperties getProperty jsonValue remoteObject toString

$ $$ $$eval $eval asLocator autofill backendNodeId boundingBox boxModel click clickablePoint contentFrame drag dragAndDrop dragEnter dragOver drop focus hover isHidden isIntersectingViewport isVisible press screenshot scrollIntoView select tap toElement touchEnd touchMove touchStart type uploadFile waitForSelector

abort abortErrorReason continue continueRequestOverrides enqueueInterceptAction failure fetchPostData finalizeInterceptions frame hasPostData headers initiator interceptResolutionState isInterceptResolutionHandled isNavigationRequest method postData redirectChain resourceType respond response responseForRequest url

buffer content frame fromCache fromServiceWorker headers json ok remoteAddress request securityDetails status statusText text timing url

SecurityDetails

issuer protocol subjectAlternativeNames subjectName validFrom validTo

asPage browser browserContext createCDPSession opener page type url worker

connection detach id send

startCSSCoverage startJSCoverage stopCSSCoverage stopJSCoverage

[asyncDisposeSymbol] [disposeSymbol] emit listenerCount off on once removeAllListeners

ActionOptions ActionResult AdapterState AddScreenParams asyncDisposeSymbol AutofillAddressField AutofillData Awaitable AwaitableIterable AwaitablePredicate AwaitedLocator

BluetoothEmulation

disableEmulation emulateAdapter simulatePreconnectedPeripheral

BluetoothManufacturerData BoundingBox BoxModel BrowserContextEvent BrowserContextEvents BrowserContextOptions BrowserEvent BrowserEvents

BrowserLauncher

defaultArgs executablePath launch

CDPSessionEvent

SessionAttached SessionDetached

CDPSessionEvents ChromeHeadlessShellSettings ChromeReleaseChannel ChromeSettings ClickOptions CommandOptions

CommonEventEmitter

emit listenerCount off on once removeAllListeners

Configuration connect

createSession dispose fromSession send session url

ConnectionClosedError

ConnectionTransport

ConnectOptions ConsoleMessageLocation ConsoleMessageType ContinueRequestOverrides Cookie CookieData CookieParam CookiePartitionKey CookiePriority CookieSameSite_2 CookieSourceScheme CoverageEntry CreatePageOptions Credentials

(constructor) start stop

CSSCoverageOptions CustomQueryHandler DEBUG_PREFIXES DebugInfo DebugPrefix DEFAULT_INTERCEPT_RESOLUTION_PRIORITY defaultArgs DeleteCookiesRequest Device

DeviceRequestPrompt

cancel select waitForDevice

DeviceRequestPromptDevice disposeSymbol DownloadBehavior DownloadPolicy ElementFor ElementScreenshotOptions ErrorCode EvaluateFunc EvaluateFuncWith EventsWithWildcard EventType executablePath ExperimentsConfiguration

pages triggerAction workers

ExtensionInstallOptions

ExtensionTransport

close connectTab send

FirefoxSettings FlattenHandle FrameAddScriptTagOptions FrameAddStyleTagOptions FrameEvents FrameWaitForFunctionOptions GeolocationOptions GetPWAStateOptions GoToOptions HandleFor HandleOr Handler HeapSnapshotOptions ImageFormat InnerParams InstallPWAOptions InterceptResolutionAction InterceptResolutionState InternalNetworkConditions Issue

JSCoverageEntry JSCoverageOptions KeyboardTypeOptions KeyDownOptions KeyInput KeyPressOptions KnownDevices launch LaunchOptions LaunchPWAOptions LocatorClickOptions LocatorEvent LocatorEvents LocatorFillOptions LocatorScrollOptions Logger LoggerFunction LowerCasePaperFormat Mapper MediaFeature Metrics MouseButton MouseClickOptions MouseMoveOptions MouseOptions MouseWheelOptions

NetworkConditions NewDocumentScriptEvaluation NodeFor Offset PageEvent PageEvents PaperFormat PDFMargin PDFOptions Permission PermissionDescriptor_2 PermissionState_2 Point PreconnectedPeripheral PredefinedNetworkConditions Predicate ProtocolError ProtocolLifeCycleEvent ProtocolType puppeteer PuppeteerError PuppeteerLifeCycleEvent PWADisplayMode PWAState Quad QueryOptions

[disposeSymbol] evaluate evaluateHandle extension waitForFunction

ReloadOptions RemoteAddress ResourceType ResponseForRequest ScreencastOptions ScreenInfo ScreenOrientation_2

[asyncDisposeSymbol] stop

ScreenshotClip ScreenshotOptions

SerializedAXNode

SetContentWaitForOptions SnapshotOptions SupportedBrowser SupportedWebDriverCapabilities SupportedWebDriverCapability TargetFilterCallback TargetType TouchError

TracingOptions trimCache UninstallPWAOptions UnsupportedOperation VideoFormat Viewport VisibilityOption WaitForNetworkIdleOptions WaitForOptions WaitForSelectorOptions WaitForTargetOptions WaitTimeoutOptions

WebMCPToolCall WebMCPToolCallResult WebMCPToolsAddedEvent WebMCPToolsRemovedEvent WebWorkerEvent WebWorkerEvents WindowBounds WindowId WindowState WorkAreaInsets

LocatorEvents 接口

签名

export interface LocatorEvents extends Record<EventType, unknown>

继承自： Record<EventType, unknown>

属性

属性	修饰符	类型	说明	默认值
action		undefined

本页为 pptr.dev v25.8.0 文档的中文翻译 · 原文 © Google Inc. · Apache-2.0 · 源文档由 puppeteer/puppeteer 提供

本页目录