Replicating WebFrame::uniqueName across renderers.

third_party/WebKit/Source/core/page/FrameTree.h

 /*
  * Copyright (C) 2006 Apple Computer, Inc.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ skipping 24 matching lines @@
 public:
     explicit FrameTree(Frame* thisFrame);
     ~FrameTree();
 
     const AtomicString& name() const { return m_name; }
     const AtomicString& uniqueName() const { return m_uniqueName; }
     // If |name| is not empty, |fallbackName| is ignored. Otherwise,
     // |fallbackName| is used as a source of uniqueName.
     void setName(const AtomicString& name, const AtomicString& fallbackName = nullAtom);
 
-    // Directly assigns both the name and uniqueName. Should only be used when
-    // switching between LocalFrames and RemoteFrames for the same logical frame
-    // so that the unique name stays unique.
-    void setNameForReplacementFrame(const AtomicString& name, const AtomicString& uniqueName);
+    // Directly assigns both the name and uniqueName.  Can be used when
+    // |uniqueName| is already known (i.e. when it has been precalculated by
+    // calculateUniqueNameForNewChildFrame OR when replicating the name between
+    // LocalFrames and RemoteFrames for the same logical frame).
+    void setPrecalculatedName(const AtomicString& name, const AtomicString& uniqueName);
 
     Frame* parent() const;
     Frame* top() const;
     Frame* previousSibling() const;
     Frame* nextSibling() const;
     Frame* firstChild() const;
     Frame* lastChild() const;
 
     bool isDescendantOf(const Frame* ancestor) const;
     Frame* traversePreviousWithWrap(bool) const;
     Frame* traverseNext(const Frame* stayWithin = nullptr) const;
     Frame* traverseNextWithWrap(bool) const;
 
     Frame* child(const AtomicString& name) const;
     Frame* find(const AtomicString& name) const;
     unsigned childCount() const;
 
     Frame* scopedChild(unsigned index) const;
     Frame* scopedChild(const AtomicString& name) const;
     unsigned scopedChildCount() const;
     void invalidateScopedChildCount();
 
     DECLARE_TRACE();
 
+    AtomicString calculateUniqueNameForNewChildFrame(
+        const AtomicString& name,
+        const AtomicString& fallbackName = nullAtom) const;
+
 private:
     Frame* deepLastChild() const;
-    AtomicString uniqueChildName(const AtomicString& requestedName) const;
+    AtomicString calculateUniqueNameForChildFrame(
+        bool existingChildFrame,
+        const AtomicString& name,
+        const AtomicString& fallbackName = nullAtom) const;
     bool uniqueNameExists(const AtomicString& name) const;
 
     RawPtrWillBeMember<Frame> m_thisFrame;
 
     AtomicString m_name; // The actual frame name (may be empty).
     AtomicString m_uniqueName;
 
     mutable unsigned m_scopedChildCount;
 };
 
 } // namespace blink
 
 #ifndef NDEBUG
 // Outside the WebCore namespace for ease of invocation from gdb.
 void showFrameTree(const blink::Frame*);
 #endif
 
 #endif // FrameTree_h