Implement .wait(function)

Description

const { Chromeless } = require('chromeless')

async function run() {
  const chromeless = new Chromeless()

  const onRequest = (params) => {
    if (params.request.url.includes('my.domain.xyz/api/something')) {
      console.log(params.request);
    }
  }

  const screenshot = await chromeless
    .goto('https://my.domain.xyz', onRequest)
    .waitAjax([{url: 'XXX1', type: 'post'}]) //  waiting network response back to screenshot 
    .screenshot()

  console.log(screenshot) // prints local file path or S3 url

  await chromeless.end()
}

run().catch(console.error.bind(console))

Contributor guide

Tech stack

typescriptnodejs

Domain

testing

Issue type

feature

DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.

3

Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.

1-2 days

Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.

stale

ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.

needs investigation

Prerequisites

Basic knowledge of Chromeless APIUnderstanding of async/await in JavaScriptFamiliarity with network request interception

Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.

45

Research direction

Review the existing Chromeless source code to understand the current API design, particularly how methods like `goto` and `screenshot` are implemented. Look for any existing network request handling or interception mechanisms. The issue proposes a `.waitAjax` method, so investigate how to hook into network events using Chrome DevTools Protocol. Also check if there is a `.wait` method already implemented but not documented. Since no PRs or comments exist, first time contributors should start by asking clarifying questions about the exact expected behavior and signature of `.wait(function)`.