schickling/chromeless

Feature request: api for DOM selectors using css

Open

#160 opened on Aug 3, 2017

View on GitHub
 (0 comments) (0 reactions) (0 assignees)TypeScript (13,240 stars) (606 forks)batch import
APIfeaturehelp wanted

Description

I have been testing E2E tools this week and I was quite excited when I discovered this project.

Just my two cents, I don't know if any of you guys know about TestCafe, but they have a very cool way to create selectors for DOM nodes.

import { Selector } from 'testcafe';

// A selector is created from a CSS selector string.
const submitButton = Selector('#submit-button');

then you can just use that on your tests:

.wait(submitButton)
.click(submitButton)

But the beauty of that API is that you can create plugins around that. They also managed to create another tool around the selectors a plugin for React

const myDiv = ReactSelector('TodoApp div');

I guess this would solve a lot of requests similar to https://github.com/graphcool/chromeless/issues/134

Contributor guide

Tech stack
typescriptjavascript
Domain
testingapi
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.
half day
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.
mostly clear
Prerequisites
TypeScript basicsCSS selectorsFamiliarity with Chromeless API
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30
Research direction
Investigate the current Chromeless API for DOM interactions (e.g., in src/). Look at how TestCafe implements Selector and ReactSelector as referenced in the issue. Consider implementing a similar wrapper that accepts CSS selector strings and returns a selector object. Check linked issue #134 for related context. No existing PRs or comments indicate ongoing work.