Content bug: proxyInfo.proxyDNS in webRequest event is not clear

I’m stuck with GitHub account problem for couple days, It turns out they’re not going to unflag my account even I proved that I come to GitHub to contribute not spam and the opened issue are not seem by anyone.

So I post the issue here, wish someone can help move it to mdn/content. Or do the fix.


What page(s) did you find the problem on?

and other WebRequest events

Specific page section or heading?

In section “Additional objects”: details > proxyInfo > proxyDNS

What is the problem?

The description of this attribute is missing some information. and can mislead some programers. The current is:

proxyDNS
boolean. True if the proxy will perform domain name resolution based on the hostname supplied, meaning that the client should not do its own DNS lookup.

But, the value of this attribute should only used when the proxyInfo.type is socks4 or socks5.

Just like the description on this page

proxyDNS

boolean. If true, the proxy server is used to resolve certain DNS queries (only usable with “socks4” and “socks”). Defaults to false.

What did you expect to see?

Document it more precisely.

Did you test this? If so, how?

There has a wildly used web extension misuse this attribute, due to this lack of precise documentation. And cause some security problems.