SeleniumHQ / SeleniumHQ/htmlunit-driver

More documentation is needed!

Open
#94 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Java
Stars
266
Forks
91
PR merge metrics
No merged PRs in 30d

Description

Hello to the developers of HtmlUnitDriver,

You saved my sanity! Let me explain. I've been using HtmlUnit for a long time and it was working fine but recently within these last 6 months or so I was having trouble logging into a website.

It was driving me crazy because I could only get my app to login during a certain time period of the day. If I tried to login during another time it would reject me so I realized it must be determining that I was logging in through an app.

I could always login using a browser, manually, no problem so I spent a considerable amount of time trying to figure out what was different? I turned on debug logging in htmlunit and even with a detailed trace I couldn't figure out how it knew.

But yesterday as I was researching this problem I ran across HtmlUnitDriver. I knew of Selenium but I was never really interested as I needed a pure java headless browser that was lightweight and easy to use.

But after reading more about HtmlUnitDriver I decided to give it a try. Maybe it could fake out this website. How I didn't know as it wasn't doing something too complex, it just needed it to log me into this website.

But what do you know, it worked! How I really don't know? What is HtmlUnitDriver doing differently than HtmlUnit? I really have know clue. I wish there was more documentation. I've looked on the web but there's really not much out there.

Given this, I will now use HtmlUnitDriver if I have trouble as it's as close to a real browser as possible but I really wish someone would explain to me what it's doing that's so different?

Any explanation or additional documentation would be grateful. Otherwise I'm stuck analyzing the code and trying to figure this out on my own. This is tough as my java skills are rusty so any help would be appreciated.

Thank you again.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the HtmlUnitDriver entry point and compare its behavior with HtmlUnit, focusing on what differs during website login. No files or tests are identified in the issue; the work is done when documentation clearly explains these differences and provides useful guidance for users.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.