IntersectionObserver: use nullptr for implicit root.

third_party/WebKit/Source/core/dom/IntersectionObserver.h

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef IntersectionObserver_h
 #define IntersectionObserver_h
 
 #include "bindings/core/v8/ExceptionStatePlaceholder.h"
 #include "bindings/core/v8/ScriptWrappable.h"
 #include "core/dom/IntersectionObservation.h"
 #include "core/dom/IntersectionObserverEntry.h"
 #include "platform/Length.h"
 #include "platform/heap/Handle.h"
 #include "wtf/HashSet.h"
 #include "wtf/Vector.h"
 
 namespace blink {
 
 class Document;
 class Element;
 class ExceptionState;
 class IntersectionObserverCallback;
 class IntersectionObserverInit;
+class LayoutObject;
 
 class CORE_EXPORT IntersectionObserver final
     : public GarbageCollectedFinalized<IntersectionObserver>,
       public ScriptWrappable {
   DEFINE_WRAPPERTYPEINFO();
 
  public:
   using EventCallback =
       Function<void(const HeapVector<Member<IntersectionObserverEntry>>&),
                WTF::SameThreadAffinity>;
 
   // Defines the assumed initial state of the observed element. If the actual
   // state is the same as the initial state, then no observation will be
   // delivered. kAuto means the initial observation will always get sent.
-  enum class InitialState {
+  enum InitialState {
     // TODO(skyostil): Add support for kVisible.
-    kAuto,
-    kHidden,
+    kAuto = 0,
+    kHidden = 1,
   };
 
   static IntersectionObserver* create(const IntersectionObserverInit&,
                                       IntersectionObserverCallback&,
                                       ExceptionState&);
   static IntersectionObserver* create(const Vector<Length>& rootMargin,
                                       const Vector<float>& thresholds,
                                       Document*,
                                       std::unique_ptr<EventCallback>,
                                       ExceptionState& = ASSERT_NO_EXCEPTION);
   static void resumeSuspendedObservers();
 
   // API methods.
   void observe(Element*, ExceptionState& = ASSERT_NO_EXCEPTION);
   void unobserve(Element*, ExceptionState& = ASSERT_NO_EXCEPTION);
   void disconnect(ExceptionState& = ASSERT_NO_EXCEPTION);
   HeapVector<Member<IntersectionObserverEntry>> takeRecords(ExceptionState&);
 
   // API attributes.
-  Element* root() const;
+  Element* root() const { return m_root.get(); }
   String rootMargin() const;
   const Vector<float>& thresholds() const { return m_thresholds; }
 
-  Node* rootNode() const { return m_root.get(); }
+  // An observer can either track intersections with an explicit root Element,
+  // or with the the top-level frame's viewport (the "implicit root").  When
+  // tracking the implicit root, m_root will be null, but because m_root is a
+  // weak pointer, we cannot surmise that this observer tracks the implicit
+  // root just because m_root is null.  Hence m_rootIsImplicit.
+  bool rootIsImplicit() const { return m_rootIsImplicit; }
+
+  // This is the document which is responsible for running
+  // computeIntersectionObservations at frame generation time.
+  Document& trackingDocument() const;
+
+  LayoutObject* rootLayoutObject() const;

[kenrb, 2016/12/09 21:01:43]

This does not appear to have any callers.

[szager1, 2016/12/10 20:51:18]

Removed.

   const Length& topMargin() const { return m_topMargin; }
   const Length& rightMargin() const { return m_rightMargin; }
   const Length& bottomMargin() const { return m_bottomMargin; }
   const Length& leftMargin() const { return m_leftMargin; }
   void computeIntersectionObservations();
   void enqueueIntersectionObserverEntry(IntersectionObserverEntry&);
   unsigned firstThresholdGreaterThan(float ratio) const;
   void deliver();
   void removeObservation(IntersectionObservation&);
   bool hasEntries() const { return m_entries.size(); }
   const HeapLinkedHashSet<WeakMember<IntersectionObservation>>& observations()
       const {
     return m_observations;
   }
 
   // Set the assumed initial state of the observed element. Note that this can
   // only be set before calling observe().
   // TODO(skyostil): Move this setting to IntersectionObserverInit once the API
   // is finalized.
   void setInitialState(InitialState);
 
   DECLARE_TRACE();
 
  private:
   explicit IntersectionObserver(IntersectionObserverCallback&,
-                                Node&,
+                                Element*,
                                 const Vector<Length>& rootMargin,
                                 const Vector<float>& thresholds);
   void clearWeakMembers(Visitor*);
 
+  // Returns false if this observer has an explicit root element which has been
+  // deleted; true otherwise.
+  bool rootIsValid() const;
+
   Member<IntersectionObserverCallback> m_callback;
-  WeakMember<Node> m_root;
+  WeakMember<Element> m_root;
   HeapLinkedHashSet<WeakMember<IntersectionObservation>> m_observations;
   HeapVector<Member<IntersectionObserverEntry>> m_entries;
   Vector<float> m_thresholds;
   Length m_topMargin;
   Length m_rightMargin;
   Length m_bottomMargin;
   Length m_leftMargin;
-  InitialState m_initialState;
+  unsigned m_rootIsImplicit : 1;
+  unsigned m_initialState : 1;
 };
 
 }  // namespace blink
 
 #endif  // IntersectionObserver_h