Move persistent gesture state to Document, add DocumentUserGestureToken

third_party/WebKit/Source/core/dom/DocumentUserGestureToken.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 DocumentUserGestureToken_h
+#define DocumentUserGestureToken_h
+
+#include "core/dom/Document.h"
+#include "platform/UserGestureIndicator.h"
+
+namespace blink {
+
+// Associates a UserGestureToken with a Document, if a non-null Document*
+// is provided in the constructor.
+class DocumentUserGestureToken final : public UserGestureToken {
+  WTF_MAKE_NONCOPYABLE(DocumentUserGestureToken);
+
+ public:
+  static PassRefPtr<UserGestureToken> create(
+      Document* document,
+      Status status = PossiblyExistingGesture) {
+    return adoptRef(new DocumentUserGestureToken(document, status));
+  }
+
+  ~DocumentUserGestureToken() final {}
+
+ private:
+  DocumentUserGestureToken(Document* document, Status status)
+      : UserGestureToken(status) {
+    // TODO(japhet): This doesn't work if an ancestor is remote.
+    // See http://crbug.com/658800

[Charlie Reis, 2016/10/24 21:38:16]

What are the consequences of leaving this as a TODO?  OOPIFs are live on Chrome
Beta and we're very close to turning them on for Stable, so we can't take on
more blocking bugs or TODOs like this.  I'd like this to be resolved before
landing, unless it's clear that the current behavior isn't a problem.

+    for (; document; document = document->parentDocument()) {
+      if (document)
+        document->setHasReceivedUserGesture();
+    }
+  }
+};
+
+}  // namespace blink
+
+#endif  // DocumentUserGestureToken_h