withTagName has no JavaScript reference documentation

[mitchcurtis]

🐛 Bug Report

There doesn't appear to be any documentation for withTagName:

https://www.selenium.dev/selenium/docs/api/javascript/module/selenium-webdriver/

Git blame says 13f415b added it.

In the Java bindings, withTagName was removed altogether:

6a3f867

Is this API expected to stay? Judging from the code, it is public at least:

selenium/javascript/node/selenium-webdriver/lib/by.js

Lines 408 to 415 in 64447d4

	// PUBLIC API
	module.exports = {
	By: By,
	RelativeBy: RelativeBy,
	withTagName: withTagName,
	checkedLocator: check,
	}

Environment

OS: Windows 10
Browser: Firefox
Browser version: 89.0 (64-bit)
Browser Driver version: geckodriver 0.29.1 (970ef713fe58 2021-04-08 23:34 +0200)
Language Bindings version: ?

[AutomatedTester]

I have a fix for this. We are going to be using a new API but won't break anything so will see about deprecating it properly.

[github-actions]

This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.