`caretRangeFromPoint` return type should be `Range | null`

[melink14]

caretRangeFromPoint Update Request

Configuration Check

My compilation target is ES2020 and my lib is caretRangeFromPoint.

Missing / Incorrect Definition

caretRangeFromPoint is currently defined as:

caretRangeFromPoint(x: number, y: number): Range;

but should be

caretRangeFromPoint(x: number, y: number): Range | null;

Sample Code

// Calculate range and friends here after we've made our fake textarea/input divs.
range = document.caretRangeFromPoint(ev.clientX, ev.clientY);
const startNode = range.startContainer;

This code should have a type error but currently doesn't since library doens't show return type as nullable. This happens quite often in the wild.

Documentation Link

https://developer.mozilla.org/en-US/docs/Web/API/Document/caretRangeFromPoint also shows null as possible return type.

[melink14]

Ah, I filed based on reading the commits that added it but it seems it was deleted from this repo since.
019c953#diff-72e8dfbf8f82281b296a7355a166f0d69adbcc4957ba52f66d7c32be0b62cc41L44

But it still is in Typescript's generated DOM types and my google fu is weak so a pointer would be appreciated.

[edited to fix commit reference]

[saschanaz]

Hmm, it's one of rare things that exists in browsers but not in the spec. I filed w3c/csswg-drafts#6459 and will add this one manually.