ChangeLog

2020-09-12  Darin Adler  <darin@apple.com>

        Make Selection throw same errors as other browsers and return same Range object from getRangeAt like other browsers

        https://bugs.webkit.org/show_bug.cgi?id=216325

2020-09-13  Sam Weinig  <weinig@apple.com>

        [WebIDL] Remove need for [MayThrowException] on constructors and legacy factory functions

Source/WebCore/dom/Document.h

@@public:

    void canvasResized(CanvasBase&) final { };

    void canvasDestroyed(CanvasBase&) final;

    bool contains(const Node& node) const { return this == &node.treeScope() && node.isConnected(); }

    bool contains(const Node* node) const { return node && contains(*node); }

protected:

    enum ConstructionFlags { Synthesized = 1, NonRenderedPlaceholder = 1 << 1 };

    WEBCORE_EXPORT Document(Frame*, const URL&, DocumentClassFlags = DefaultDocumentClass, unsigned constructionFlags = 0);

Source/WebCore/dom/Node.cpp

 * Copyright (C) 1999 Lars Knoll (knoll@kde.org)

 *           (C) 1999 Antti Koivisto (koivisto@kde.org)

 *           (C) 2001 Dirk Mueller (mueller@kde.org)

 * Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies)

 * Copyright (C) 2009 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/)

 *

@@ExceptionOr<void> Node::checkSetPrefix(const AtomString& prefix)

bool Node::isDescendantOf(const Node& other) const

{

1024 // Return true if other is an ancestor of this, otherwise false

    // Return true if other is an ancestor of this.

    if (other.isDocumentNode())

        return &treeScope().rootNode() == &other && !isDocumentNode() && isConnected();

10251027 if (!other.hasChildNodes() || isConnected() != other.isConnected())

10261028 return false;

    if (other.isDocumentNode())

        return &document() == &other && !isDocumentNode() && isConnected();

    for (const auto* ancestor = parentNode(); ancestor; ancestor = ancestor->parentNode()) {

1029 for (auto ancestor = parentNode(); ancestor; ancestor = ancestor->parentNode()) {

        if (ancestor == &other)

            return true;

    }

@@bool Node::isDescendantOf(const Node& other) const

bool Node::isDescendantOrShadowDescendantOf(const Node* other) const

{

    // FIXME: This element's shadow tree's host could be inside another shadow tree.

    // This function doesn't handle that case correctly. Maybe share code with

    // the containsIncludingShadowDOM function?

1038 // FIXME: Correctly handle the case where the shadow host is itself in a shadow tree.

    return other && (isDescendantOf(*other) || other->contains(shadowHost()));

}

1044 bool Node::contains(const Node* node) const

1042bool Node::contains(const Node& node) const

10451043{

1046 return this == node || (node ~~&& node->~~isDescendantOf(*this));

1044 return this == &node || node.isDescendantOf(*this);

}

bool Node::containsIncludingShadowDOM(const Node* node) const

Source/WebCore/dom/Node.h

 * Copyright (C) 1999 Lars Knoll (knoll@kde.org)

 *           (C) 1999 Antti Koivisto (koivisto@kde.org)

 *           (C) 2001 Dirk Mueller (mueller@kde.org)

 * Copyright (C) 2008, 2009 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/)

 *

 * This library is free software; you can redistribute it and/or

@@public:

    WEBCORE_EXPORT bool isDescendantOf(const Node&) const;

    bool isDescendantOf(const Node* other) const { return other && isDescendantOf(*other); }

374 WEBCORE_EXPORT bool contains(const Node&) const;

375 bool contains(const Node* other) const { return other && contains(*other); }

374376

375377 bool isDescendantOrShadowDescendantOf(const Node*) const;

376 WEBCORE_EXPORT bool contains(const Node*) const;

    WEBCORE_EXPORT bool containsIncludingShadowDOM(const Node*) const;

    // Whether or not a selection can be started in this object

Source/WebCore/dom/Range.cpp

 * (C) 2000 Gunnstein Lye (gunnstein@netcom.no)

 * (C) 2000 Frederik Holljen (frederik.holljen@hig.no)

 * (C) 2001 Peter Kelly (pmk@post.com)

 * Copyright (C) 2011 Motorola Mobility. All rights reserved.

 *

 * This library is free software; you can redistribute it and/or

#include "DOMRect.h"

#include "DOMRectList.h"

#include "DocumentFragment.h"

32 #include "Editing.h"

3332#include "Event.h"

3433#include "Frame.h"

34#include "FrameSelection.h"

#include "FrameView.h"

#include "GeometryUtilities.h"

#include "HTMLBodyElement.h"

38 #include "HTMLElement.h"

#include "HTMLHtmlElement.h"

#include "HTMLNames.h"

#include "NodeTraversal.h"

#include "NodeWithIndex.h"

#include "ProcessingInstruction.h"

#include "RenderBlock.h"

#include "RenderBoxModelObject.h"

#include "RenderText.h"

#include "RenderView.h"

4843#include "ScopedEventQueue.h"

4944#include "TextIterator.h"

50 #include "VisiblePosition.h"

#include "VisibleUnits.h"

#include "markup.h"

#include <stdio.h>

#include <wtf/text/CString.h>

#include <wtf/text/StringBuilder.h>

#if PLATFORM(IOS_FAMILY)

#include "SelectionRect.h"

#endif

namespace WebCore {

using namespace HTMLNames;

@@Ref<Range> Range::create(Document& ownerDocument)

Range::~Range()

{

83 ASSERT(!m_isAssociatedWithSelection);

84

    m_ownerDocument->detachRange(*this);

#ifndef NDEBUG

@@void Range::updateDocument()

    auto& document = startContainer().document();

    if (m_ownerDocument.ptr() == &document)

        return;

    if (m_isAssociatedWithSelection) {

        m_ownerDocument->selection().clear();

        m_isAssociatedWithSelection = false;

    }

    m_ownerDocument->detachRange(*this);

    m_ownerDocument = document;

    m_ownerDocument->attachRange(*this);

}

void Range::updateAssociatedSelection()

{

    if (m_isAssociatedWithSelection)

        m_ownerDocument->selection().updateFromAssociatedLiveRange();

}

ExceptionOr<void> Range::setStart(Ref<Node>&& container, unsigned offset)

{

    auto childNode = checkNodeOffsetPair(container, offset);

@@ExceptionOr<void> Range::setStart(Ref<Node>&& container, unsigned offset)

    if (!is_lteq(documentOrder(makeBoundaryPoint(m_start), makeBoundaryPoint(m_end))))

        m_end = m_start;

    updateDocument();

122 updateAssociatedSelection();

    return { };

}

@@ExceptionOr<void> Range::setEnd(Ref<Node>&& container, unsigned offset)

    if (!is_lteq(documentOrder(makeBoundaryPoint(m_start), makeBoundaryPoint(m_end))))

        m_start = m_end;

    updateDocument();

136 updateAssociatedSelection();

    return { };

}

@@void Range::collapse(bool toStart)

        m_end = m_start;

    else

        m_start = m_end;

146 updateAssociatedSelection();

}

ExceptionOr<bool> Range::isPointInRange(Node& container, unsigned offset)

@@ExceptionOr<RefPtr<DocumentFragment>> Range::processContents(ActionType action)

            if (result.hasException())

                return result.releaseException();

        }

371 m_~~end = m_s~~tart;

376 collapse(true);

    }

    // Now add leftContents, stuff in between, and rightContents to the fragment

@@ExceptionOr<void> Range::selectNodeContents(Node& node)

{

    if (node.isDocumentTypeNode())

        return Exception { InvalidNodeTypeError };

774

775779 m_start.setToBeforeContents(node);

776780 m_end.setToAfterContents(node);

781 updateDocument();

782 updateAssociatedSelection();

    return { };

}

@@Optional<SimpleRange> makeSimpleRange(const RefPtr<Range>& range)

Ref<Range> createLiveRange(const SimpleRange& range)

{

    auto result = Range::create(range.start.document());

    result.get() = range;

    return result;

}

Range& Range::operator=(const SimpleRange& range)

{

10601072 auto startContainer = range.start.container;

1061 ~~result->~~setStart(WTFMove(startContainer), range.start.offset);

1073 setStart(WTFMove(startContainer), range.start.offset);

10621074 auto endContainer = range.end.container;

1063 ~~result->~~setEnd(WTFMove(endContainer), range.end.offset);

1064 return re~~sult~~;

1075 setEnd(WTFMove(endContainer), range.end.offset);

1076 return *this;

}

RefPtr<Range> createLiveRange(const Optional<SimpleRange>& range)

Source/WebCore/dom/Range.h

@@public:

    void textNodesMerged(NodeWithIndex& oldNode, unsigned offset);

    void textNodeSplit(Text& oldNode);

    void wasAssociatedWithSelection() { m_isAssociatedWithSelection = true; }

    void wasDisassociatedFromSelection() { m_isAssociatedWithSelection = false; }

#if ENABLE(TREE_DEBUGGING)

    String debugDescription() const;

#endif

    enum ActionType : uint8_t { Delete, Extract, Clone };

111 Range& operator=(const SimpleRange&);

112

private:

    explicit Range(Document&);

    void updateDocument();

117 void updateAssociatedSelection();

    ExceptionOr<Node*> checkNodeOffsetPair(Node&, unsigned offset) const;

    ExceptionOr<RefPtr<DocumentFragment>> processContents(ActionType);

    Ref<Document> m_ownerDocument;

    RangeBoundaryPoint m_start;

    RangeBoundaryPoint m_end;

124 bool m_isAssociatedWithSelection { false };

};

WEBCORE_EXPORT SimpleRange makeSimpleRange(const Range&);

Source/WebCore/editing/FrameSelection.cpp

11/*

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

@@void FrameSelection::setSelectionByMouseIfDifferent(const VisibleSelection& pass

    newSelection.setIsDirectional(isDirectional); // Adjusting base and extent will make newSelection always directional

    if (m_selection == newSelection || !shouldChangeSelection(newSelection))

        return;

317

    
    AXTextStateChangeIntent intent;

    if (AXObjectCache::accessibilityEnabled() && newSelection.isCaret())

@@bool FrameSelection::setSelectionWithoutUpdatingAppearance(const VisibleSelectio

    if (!m_document || !m_document->frame()) {

        m_selection = newSelection;

337 updateAssociatedLiveRange();

        return false;

    }

@@bool FrameSelection::setSelectionWithoutUpdatingAppearance(const VisibleSelectio

        m_document->editor().selectionWillChange();

    m_selection = newSelection;

371 updateAssociatedLiveRange();

    // Selection offsets should increase when LF is inserted before the caret in InsertLineBreakCommand. See <https://webkit.org/b/56061>.

    if (HTMLTextFormControlElement* textControl = enclosingTextFormControl(newSelection.start()))

@@void FrameSelection::setCaretColor(const Color& caretColor)

            invalidateCaretRect();

    }

}

2780

27792781#endif // PLATFORM(IOS_FAMILY)

27802782

static bool isRootNode(Document* document, const Optional<SimpleRange>& range)

{

    return document && range && document->contains(range->start.container) && document->contains(range->end.container);

}

static bool isRootNode(Document* document, const Range& liveRange)

{

    // Only need to check the start container because live ranges enforce the invariant that start and end have a common ancestor.

    return document && document->contains(liveRange.startContainer());

}

RefPtr<Range> FrameSelection::associatedLiveRange()

{

    if (!m_associatedLiveRange) {

        if (auto range = m_selection.firstRange(); isRootNode(m_document, range)) {

            m_associatedLiveRange = createLiveRange(*range);

            m_associatedLiveRange->wasAssociatedWithSelection();

        }

    }

    return m_associatedLiveRange;

}

void FrameSelection::disassociateLiveRange()

{

    if (auto previouslyAssociatedLiveRange = std::exchange(m_associatedLiveRange, nullptr))

        previouslyAssociatedLiveRange->wasDisassociatedFromSelection();

}

void FrameSelection::associateLiveRange(Range& liveRange)

{

    disassociateLiveRange();

    m_associatedLiveRange = &liveRange;

    liveRange.wasAssociatedWithSelection();

    updateFromAssociatedLiveRange();

}

void FrameSelection::updateFromAssociatedLiveRange()

{

    ASSERT(m_associatedLiveRange);

    if (!isRootNode(m_document, *m_associatedLiveRange))

        disassociateLiveRange();

    else

        setSelection(makeSimpleRange(*m_associatedLiveRange));

    // FIXME: Normalization done by setSelection will be visible next time updateAssociatedLiveRange is called. Instead the Selection API specification calls for allowing non-normalized selection ranges.

}

void FrameSelection::updateAssociatedLiveRange()

{

    auto range = m_selection.firstRange();

    if (!isRootNode(m_document, range))

        disassociateLiveRange();

    else if (m_associatedLiveRange) {

        // Tell the live range it's not associated while modifying it so it doesn't call updateFromAssociatedLiveRange.

        m_associatedLiveRange->wasDisassociatedFromSelection();

        *m_associatedLiveRange = *range;

        m_associatedLiveRange->wasAssociatedWithSelection();

    }

}

}

#if ENABLE(TREE_DEBUGGING)

2785 void showTree(const WebCore::FrameSelection& sel)

2846void showTree(const WebCore::FrameSelection& selection)

27862847{

2787 sel.showTreeForThis();

2848 selection.showTreeForThis();

27882849}

27892850

2790 void showTree(const WebCore::FrameSelection* sel)

2851void showTree(const WebCore::FrameSelection* selection)

27912852{

2792 if (sel)

2793 sel->showTreeForThis();

2853 if (selection)

2854 selection->showTreeForThis();

}

#endif

Source/WebCore/editing/FrameSelection.h

11/*

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

@@public:

    bool shouldShowBlockCursor() const { return m_shouldShowBlockCursor; }

    void setShouldShowBlockCursor(bool);

    RefPtr<Range> associatedLiveRange();

    void associateLiveRange(Range&);

    void disassociateLiveRange();

    void updateFromAssociatedLiveRange();

private:

    enum EPositionType { START, END, BASE, EXTENT };

@@private:

    Optional<SimpleRange> rangeByAlteringCurrentSelection(EAlteration, int amount) const;

#endif

331 Document* m_document;

    void updateAssociatedLiveRange();

    Document* m_document { nullptr };

    RefPtr<Range> m_associatedLiveRange;

    LayoutUnit m_xPosForVerticalArrowNavigation;

Source/WebCore/page/DOMSelection.cpp

11/*

 * Copyright (C) 2012 Google Inc. All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

namespace WebCore {

static bool shouldUseSelectionAssociatedRange()

{

    // FIXME: This will be controlled by a feature flag during development, I guess.

    return false;

}

static Node* selectionShadowAncestor(Frame& frame)

{

    auto* node = frame.selection().selection().base().anchorNode();

@@unsigned DOMSelection::rangeCount() const

    return !frame || frame->selection().isNone() ? 0 : 1;

}

169 void DOMSelection::collapse(Node* node, unsigned offset)

175ExceptionOr<void> DOMSelection::collapse(Node* node, unsigned offset)

170176{

    if (!isValidForPosition(node))

        return;

    Ref<Frame> protectedFrame(*frame());

    protectedFrame->selection().moveTo(createLegacyEditingPosition(node, offset), Affinity::Downstream);

    auto frame = makeRefPtr(this->frame());

    if (!frame)

        return { };

    if (shouldUseSelectionAssociatedRange()) {

        if (!node) {

            removeAllRanges();

            return { };

        }

        // FIXME: The Selection API specification does not mention this, but Web Platform Tests results expect it.

        if (node->isDocumentTypeNode())

            return Exception { InvalidNodeTypeError };

        // FIXME: The Selection API specification requires this exception, but it may be incompatible in practice.

        if (offset > node->length())

            return Exception { IndexSizeError };

        if (!frame->document()->contains(*node))

            return { };

    } else {

        if (!isValidForPosition(node))

            return { };

    }

    auto& selection = frame->selection();

    selection.disassociateLiveRange();

    selection.moveTo(createLegacyEditingPosition(node, offset), Affinity::Downstream);

    return { };

}

ExceptionOr<void> DOMSelection::collapseToEnd()

{

180 auto* frame = this->frame();

205 auto frame = makeRefPtr(this->frame());

    if (!frame)

        return { };

    auto& selection = frame->selection();

    if (selection.isNone())

        return Exception { InvalidStateError };

186

187 Ref<Frame> protector(*frame);

211 selection.disassociateLiveRange();

    selection.moveTo(selection.selection().end(), Affinity::Downstream);

    return { };

}

ExceptionOr<void> DOMSelection::collapseToStart()

{

194 auto* frame = this->frame();

218 auto frame = makeRefPtr(this->frame());

    if (!frame)

        return { };

    auto& selection = frame->selection();

    if (selection.isNone())

        return Exception { InvalidStateError };

200

201 Ref<Frame> protector(*frame);

224 selection.disassociateLiveRange();

    selection.moveTo(selection.selection().start(), Affinity::Downstream);

    return { };

}

void DOMSelection::empty()

{

    auto* frame = this->frame();

    if (!frame)

        return;

    frame->selection().clear();

231 removeAllRanges();

212232}

213233

214 void DOMSelection::setBaseAndExtent(Node* baseNode, unsigned baseOffset, Node* extentNode, unsigned extentOffset)

234ExceptionOr<void> DOMSelection::setBaseAndExtent(Node* baseNode, unsigned baseOffset, Node* extentNode, unsigned extentOffset)

215235{

    if (!isValidForPosition(baseNode) || !isValidForPosition(extentNode))

        return;

    Ref<Frame> protectedFrame(*frame());

    protectedFrame->selection().moveTo(createLegacyEditingPosition(baseNode, baseOffset), createLegacyEditingPosition(extentNode, extentOffset), Affinity::Downstream);

    auto frame = makeRefPtr(this->frame());

    if (!frame)

        return { };

    if (shouldUseSelectionAssociatedRange()) {

        // FIXME: The Selection API specification requires this exception, but it may be incompatible in practice.

        // FIXME: We should do this by making the arguments non-nullable in the IDL file, once shouldUseSelectionAssociatedRange is always true.

        if (!baseNode || !extentNode)

            return Exception { TypeError };

        // FIXME: The Selection API specification requires this exception, but it may be incompatible in practice.

        if (baseOffset > baseNode->length() || extentOffset > extentNode->length())

            return Exception { IndexSizeError };

        auto& document = *frame->document();

        if (!document.contains(*baseNode) || !document.contains(*extentNode))

            return { };

    } else {

        if (!isValidForPosition(baseNode) || !isValidForPosition(extentNode))

            return { };

    }

    auto& selection = frame->selection();

    selection.disassociateLiveRange();

    selection.moveTo(createLegacyEditingPosition(baseNode, baseOffset), createLegacyEditingPosition(extentNode, extentOffset), Affinity::Downstream);

    return { };

221258}

222259

223 void DOMSelection::setPosition(Node* node, unsigned offset)

260ExceptionOr<void> DOMSelection::setPosition(Node* node, unsigned offset)

224261{

    if (!isValidForPosition(node))

        return;

    Ref<Frame> protectedFrame(*frame());

    protectedFrame->selection().moveTo(createLegacyEditingPosition(node, offset), Affinity::Downstream);

262 return collapse(node, offset);

}

void DOMSelection::modify(const String& alterString, const String& directionString, const String& granularityString)

{

    auto* frame = this->frame();

    if (!frame)

        return;

    FrameSelection::EAlteration alter;

    if (equalLettersIgnoringASCIICase(alterString, "extend"))

        alter = FrameSelection::AlterationExtend;

@@void DOMSelection::modify(const String& alterString, const String& directionStri

    else

        return;

280 Re~~f<Frame> protec~~tor(*frame);

281 frame->selection().modify(alter, direction, granularity);

309 if (auto frame = makeRefPtr(this->frame()))

310 frame->selection().modify(alter, direction, granularity);

}

ExceptionOr<void> DOMSelection::extend(Node& node, unsigned offset)

@@ExceptionOr<void> DOMSelection::extend(Node& node, unsigned offset)

        return { };

    if (offset > node.length())

        return Exception { IndexSizeError };

    if (!isValidForPosition(&node))

        return { };

    frame->selection().setExtent(createLegacyEditingPosition(&node, offset), Affinity::Downstream);

    if (shouldUseSelectionAssociatedRange()) {

        if (!frame->document()->contains(node))

            return { };

    } else {

        if (!isValidForPosition(&node))

            return { };

    }

    auto& selection = frame->selection();

    selection.disassociateLiveRange();

    selection.setExtent(createLegacyEditingPosition(&node, offset), Affinity::Downstream);

    return { };

}

@@ExceptionOr<Ref<Range>> DOMSelection::getRangeAt(unsigned index)

    if (index >= rangeCount())

        return Exception { IndexSizeError };

    auto& frame = *this->frame();

338 if (shouldUseSelectionAssociatedRange())

339 return frame.selection().associatedLiveRange().releaseNonNull();

    if (auto shadowAncestor = selectionShadowAncestor(frame))

        return createLiveRange(makeSimpleRange(*makeBoundaryPointBeforeNode(*shadowAncestor)));

    return createLiveRange(*frame.selection().selection().firstRange());

@@void DOMSelection::addRange(Range& liveRange)

    auto frame = makeRefPtr(this->frame());

    if (!frame)

        return;

320

321 auto range = makeSimpleRange(liveRange);

322358 auto& selection = frame->selection();

323

    if (shouldUseSelectionAssociatedRange()) {

        if (selection.isNone())

            selection.associateLiveRange(liveRange);

        return;

    }

    auto range = makeSimpleRange(liveRange);

    if (auto selectedRange = selection.selection().toNormalizedRange()) {

        if (!selectedRange->start.container->containingShadowRoot() && intersects(*selectedRange, range))

            selection.setSelection(unionRange(*selectedRange, range));

        return;

    }

329

    selection.setSelection(range);

}

ExceptionOr<void> DOMSelection::removeRange(Range& liveRange)

{

    if (&liveRange != frame()->selection().associatedLiveRange())

        return Exception { NotFoundError };

    removeAllRanges();

    return { };

}

void DOMSelection::deleteFromDocument()

{

    auto frame = makeRefPtr(this->frame());

    if (!frame)

        return;

    if (shouldUseSelectionAssociatedRange()) {

        if (auto associatedRange = frame->selection().associatedLiveRange())

            associatedRange->deleteContents();

        return;

    }

    auto selectedRange = frame->selection().selection().toNormalizedRange();

    if (!selectedRange || selectedRange->start.container->containingShadowRoot())

        return;

@@void DOMSelection::deleteFromDocument()

bool DOMSelection::containsNode(Node& node, bool allowPartial) const

{

    // FIXME: This behavior does not match what the selection API standard specifies.

    if (node.isTextNode())

        allowPartial = true;

    if (!shouldUseSelectionAssociatedRange()) {

        // FIXME: This does not match the Selection API specification.

        if (node.isTextNode())

            allowPartial = true;

    }

    auto* frame = this->frame();

    if (!frame)

@@bool DOMSelection::containsNode(Node& node, bool allowPartial) const

void DOMSelection::selectAllChildren(Node& node)

{

366 // This doesn't (and shouldn't) select text node characters.

367 setBaseAndExtent(&node, 0, &node, node.countChildNodes());

    if (shouldUseSelectionAssociatedRange())

        setBaseAndExtent(&node, 0, &node, node.length());

    else {

        // This doesn't select text node characters.

        setBaseAndExtent(&node, 0, &node, node.countChildNodes());

    }

}

String DOMSelection::toString()

@@unsigned DOMSelection::shadowAdjustedOffset(const Position& position) const

bool DOMSelection::isValidForPosition(Node* node) const

{

473 ASSERT(!shouldUseSelectionAssociatedRange());

    auto* frame = this->frame();

    return frame && (!node || &node->document() == frame->document());

}

Source/WebCore/page/DOMSelection.h

11/*

 * Copyright (C) 2012 Google Inc. All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

@@public:

    unsigned baseOffset() const;

    unsigned extentOffset() const;

    String type() const;

54 void setBaseAndExtent(Node* baseNode, unsigned baseOffset, Node* extentNode, unsigned extentOffset);

55 void setPosition(Node*, unsigned offset);

54 ExceptionOr<void> setBaseAndExtent(Node* baseNode, unsigned baseOffset, Node* extentNode, unsigned extentOffset);

55 ExceptionOr<void> setPosition(Node*, unsigned offset);

    void modify(const String& alter, const String& direction, const String& granularity);

    // The anchor and focus are the start and end of the selection, and

@@public:

    unsigned focusOffset() const;

    bool isCollapsed() const;

    unsigned rangeCount() const;

67 void collapse(Node*, unsigned offset);

67 ExceptionOr<void> collapse(Node*, unsigned offset);

    ExceptionOr<void> collapseToEnd();

    ExceptionOr<void> collapseToStart();

    ExceptionOr<void> extend(Node&, unsigned offset);

    ExceptionOr<Ref<Range>> getRangeAt(unsigned);

    void removeAllRanges();

    void addRange(Range&);

74 ExceptionOr<void> removeRange(Range&);

    void deleteFromDocument();

    bool containsNode(Node&, bool partlyContained) const;

    void selectAllChildren(Node&);

Source/WebCore/page/DOMSelection.idl

    readonly attribute boolean isCollapsed;

    readonly attribute unsigned long rangeCount;

    undefined collapse(Node? node, optional unsigned long offset = 0);

    [MayThrowException] undefined collapseToEnd();

    [MayThrowException] undefined collapseToStart();

    [CEReactions] undefined deleteFromDocument();

    boolean containsNode(Node node, optional boolean allowPartial = false);

    undefined selectAllChildren(Node node);

    [MayThrowException] undefined extend(Node node, optional unsigned long offset = 0);

44 readonly attribute DOMString type;

5345

5446 [MayThrowException] Range getRangeAt(unsigned long index);

55 undefined removeAllRanges();

5647 undefined addRange(Range range);

48 [MayThrowException] undefined removeRange(Range range);

49 undefined removeAllRanges();

5750

58 ~~[NotEnumerable] DOMString~~ ~~toString~~();

51 undefined empty();

5952

60 readonly attribute DOMString type;

    [MayThrowException] undefined collapse(Node? node, optional unsigned long offset = 0);

    [MayThrowException] undefined setPosition(Node? node, optional unsigned long offset = 0);

    [MayThrowException] undefined collapseToStart();

    [MayThrowException] undefined collapseToEnd();

6158

62 undefined setBaseAndExtent(Node? baseNode, unsigned long baseOffset, Node? extentNode, unsigned long extentOffset);

63 undefined setPosition(Node? node, optional unsigned long offset = 0);

59 [MayThrowException] undefined extend(Node node, optional unsigned long offset = 0);

6460

65 undefined empty();

    [MayThrowException] undefined setBaseAndExtent(Node? baseNode, unsigned long baseOffset, Node? extentNode, unsigned long extentOffset);

    undefined selectAllChildren(Node node);

    [CEReactions] undefined deleteFromDocument();

    boolean containsNode(Node node, optional boolean allowPartialContainment = false);

    [NotEnumerable] DOMString toString();

6668

67 // FIXME: The following operation should be implemented.

68 // undefined removeRange(Range range);

69 // Non-standard methods and attributes.

6970

70 // FIXME: Using "undefined" as default parameter value is wrong.

71 undefined modify(optional DOMString alter = "undefined", optional DOMString direction = "undefined", optional DOMString granularity = "undefined");

71 undefined modify(optional DOMString alter, optional DOMString direction, optional DOMString granularity);

    readonly attribute Node? baseNode;

    readonly attribute unsigned long baseOffset;

LayoutTests/imported/w3c/web-platform-tests/selection/removeRange-expected.txt

@@Äb̈c̈d̈ëf̈g̈ḧ

Qrstuvwx

FAIL removeRange() with Range 0 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 1 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 2 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 3 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 4 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 5 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 6 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 7 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 14 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 15 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 16 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 17 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 18 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 22 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 23 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 26 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 27 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 28 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 29 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 30 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 31 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 32 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 34 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 35 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 36 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 37 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 38 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 39 selection.removeRange is not a function. (In 'selection.removeRange(range)', 'selection.removeRange' is undefined)

FAIL removeRange() with Range 0 The object can not be found here.

FAIL removeRange() with Range 1 The object can not be found here.

FAIL removeRange() with Range 2 The object can not be found here.

FAIL removeRange() with Range 3 The object can not be found here.

FAIL removeRange() with Range 4 The object can not be found here.

FAIL removeRange() with Range 5 The object can not be found here.

FAIL removeRange() with Range 6 The object can not be found here.

FAIL removeRange() with Range 7 The object can not be found here.

FAIL removeRange() with Range 14 The object can not be found here.

FAIL removeRange() with Range 15 The object can not be found here.

FAIL removeRange() with Range 16 The object can not be found here.

FAIL removeRange() with Range 17 The object can not be found here.

FAIL removeRange() with Range 18 The object can not be found here.

FAIL removeRange() with Range 22 The object can not be found here.

FAIL removeRange() with Range 23 The object can not be found here.

FAIL removeRange() with Range 26 The object can not be found here.

FAIL removeRange() with Range 27 The object can not be found here.

FAIL removeRange() with Range 28 The object can not be found here.

FAIL removeRange() with Range 29 The object can not be found here.

FAIL removeRange() with Range 30 The object can not be found here.

FAIL removeRange() with Range 31 The object can not be found here.

FAIL removeRange() with Range 32 The object can not be found here.

FAIL removeRange() with Range 34 The object can not be found here.

FAIL removeRange() with Range 35 The object can not be found here.

FAIL removeRange() with Range 36 The object can not be found here.

FAIL removeRange() with Range 37 The object can not be found here.

FAIL removeRange() with Range 38 The object can not be found here.

FAIL removeRange() with Range 39 The object can not be found here.

3434PASS removeRange() argument is non-optional Range

3535