1 /*
2  * Copyright (C) 2011 Google Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  *     * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *     * Redistributions in binary form must reproduce the above
11  * copyright notice, this list of conditions and the following disclaimer
12  * in the documentation and/or other materials provided with the
13  * distribution.
14  *     * Neither the name of Google Inc. nor the names of its
15  * contributors may be used to endorse or promote products derived from
16  * this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #ifndef THIRD_PARTY_BLINK_RENDERER_CORE_DOM_MUTATION_RECORD_H_
32 #define THIRD_PARTY_BLINK_RENDERER_CORE_DOM_MUTATION_RECORD_H_
33 
34 #include "third_party/blink/renderer/core/core_export.h"
35 #include "third_party/blink/renderer/core/dom/static_node_list.h"
36 #include "third_party/blink/renderer/core/probe/async_task_id.h"
37 #include "third_party/blink/renderer/platform/bindings/script_wrappable.h"
38 #include "third_party/blink/renderer/platform/heap/handle.h"
39 #include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
40 
41 namespace blink {
42 
43 class Node;
44 class QualifiedName;
45 
46 using StaticNodeList = StaticNodeTypeList<Node>;
47 
48 class CORE_EXPORT MutationRecord : public ScriptWrappable {
49   DEFINE_WRAPPERTYPEINFO();
50 
51  public:
52   static MutationRecord* CreateChildList(Node* target,
53                                          StaticNodeList* added,
54                                          StaticNodeList* removed,
55                                          Node* previous_sibling,
56                                          Node* next_sibling);
57   static MutationRecord* CreateAttributes(Node* target,
58                                           const QualifiedName&,
59                                           const AtomicString& old_value);
60   static MutationRecord* CreateCharacterData(Node* target,
61                                              const String& old_value);
62   static MutationRecord* CreateWithNullOldValue(MutationRecord*);
63 
64   MutationRecord() = default;
65 
66   ~MutationRecord() override;
67 
68   virtual const AtomicString& type() = 0;
69   virtual Node* target() = 0;
70 
71   virtual StaticNodeList* addedNodes() = 0;
72   virtual StaticNodeList* removedNodes() = 0;
previousSibling()73   virtual Node* previousSibling() { return nullptr; }
nextSibling()74   virtual Node* nextSibling() { return nullptr; }
75 
attributeName()76   virtual const AtomicString& attributeName() { return g_null_atom; }
attributeNamespace()77   virtual const AtomicString& attributeNamespace() { return g_null_atom; }
78 
oldValue()79   virtual String oldValue() { return String(); }
80 
async_task_id()81   probe::AsyncTaskId* async_task_id() { return &async_task_id_; }
82 
83  private:
84   probe::AsyncTaskId async_task_id_;
85 };
86 
87 }  // namespace blink
88 
89 #endif  // THIRD_PARTY_BLINK_RENDERER_CORE_DOM_MUTATION_RECORD_H_
90