OLD | NEW |
| (Empty) |
1 // Copyright 2016 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #include "core/dom/custom/CustomElementsRegistry.h" | |
6 | |
7 #include "bindings/core/v8/ExceptionState.h" | |
8 #include "bindings/core/v8/ScriptValue.h" | |
9 #include "core/dom/Document.h" | |
10 #include "core/dom/Element.h" | |
11 #include "core/dom/ElementRegistrationOptions.h" | |
12 #include "core/dom/custom/CEReactionsScope.h" | |
13 #include "core/dom/custom/CustomElementDefinition.h" | |
14 #include "core/dom/custom/CustomElementDefinitionBuilder.h" | |
15 #include "core/dom/custom/CustomElementDescriptor.h" | |
16 #include "core/dom/custom/CustomElementTestHelpers.h" | |
17 #include "core/dom/shadow/ShadowRoot.h" | |
18 #include "core/dom/shadow/ShadowRootInit.h" | |
19 #include "core/testing/DummyPageHolder.h" | |
20 #include "platform/ScriptForbiddenScope.h" | |
21 #include "platform/heap/Handle.h" | |
22 #include "testing/gtest/include/gtest/gtest.h" | |
23 #include "wtf/text/AtomicString.h" | |
24 #include <memory> | |
25 | |
26 namespace blink { | |
27 | |
28 class CustomElementsRegistryTest : public ::testing::Test { | |
29 protected: | |
30 void SetUp() | |
31 { | |
32 m_page.reset(DummyPageHolder::create(IntSize(1, 1)).release()); | |
33 } | |
34 | |
35 void TearDown() | |
36 { | |
37 m_page = nullptr; | |
38 } | |
39 | |
40 Document& document() { return m_page->document(); } | |
41 | |
42 CustomElementsRegistry& registry() | |
43 { | |
44 return *m_page->frame().localDOMWindow()->customElements(); | |
45 } | |
46 | |
47 ScriptState* scriptState() | |
48 { | |
49 return ScriptState::forMainWorld(&m_page->frame()); | |
50 } | |
51 | |
52 void collectCandidates( | |
53 const CustomElementDescriptor& desc, | |
54 HeapVector<Member<Element>>* elements) | |
55 { | |
56 registry().collectCandidates(desc, elements); | |
57 } | |
58 | |
59 ShadowRoot* attachShadowTo(Element* element) | |
60 { | |
61 NonThrowableExceptionState noExceptions; | |
62 ShadowRootInit shadowRootInit; | |
63 return | |
64 element->attachShadow(scriptState(), shadowRootInit, noExceptions); | |
65 } | |
66 | |
67 private: | |
68 std::unique_ptr<DummyPageHolder> m_page; | |
69 }; | |
70 | |
71 TEST_F( | |
72 CustomElementsRegistryTest, | |
73 collectCandidates_shouldNotIncludeElementsRemovedFromDocument) | |
74 { | |
75 Element* element = CreateElement("a-a").inDocument(&document()); | |
76 registry().addCandidate(element); | |
77 | |
78 HeapVector<Member<Element>> elements; | |
79 collectCandidates( | |
80 CustomElementDescriptor("a-a", "a-a"), | |
81 &elements); | |
82 | |
83 EXPECT_TRUE(elements.isEmpty()) | |
84 << "no candidates should have been found, but we have " | |
85 << elements.size(); | |
86 EXPECT_FALSE(elements.contains(element)) | |
87 << "the out-of-document candidate should not have been found"; | |
88 } | |
89 | |
90 TEST_F( | |
91 CustomElementsRegistryTest, | |
92 collectCandidates_shouldNotIncludeElementsInDifferentDocument) | |
93 { | |
94 Element* element = CreateElement("a-a").inDocument(&document()); | |
95 registry().addCandidate(element); | |
96 | |
97 Document* otherDocument = HTMLDocument::create(); | |
98 otherDocument->appendChild(element); | |
99 EXPECT_EQ(otherDocument, element->ownerDocument()) | |
100 << "sanity: another document should have adopted an element on append"; | |
101 | |
102 HeapVector<Member<Element>> elements; | |
103 collectCandidates( | |
104 CustomElementDescriptor("a-a", "a-a"), | |
105 &elements); | |
106 | |
107 EXPECT_TRUE(elements.isEmpty()) | |
108 << "no candidates should have been found, but we have " | |
109 << elements.size(); | |
110 EXPECT_FALSE(elements.contains(element)) | |
111 << "the adopted-away candidate should not have been found"; | |
112 } | |
113 | |
114 TEST_F( | |
115 CustomElementsRegistryTest, | |
116 collectCandidates_shouldOnlyIncludeCandidatesMatchingDescriptor) | |
117 { | |
118 CustomElementDescriptor descriptor("hello-world", "hello-world"); | |
119 | |
120 // Does not match: namespace is not HTML | |
121 Element* elementA = CreateElement("hello-world") | |
122 .inDocument(&document()) | |
123 .inNamespace("data:text/date,1981-03-10"); | |
124 // Matches | |
125 Element* elementB = CreateElement("hello-world").inDocument(&document()); | |
126 // Does not match: local name is not hello-world | |
127 Element* elementC = CreateElement("button") | |
128 .inDocument(&document()) | |
129 .withIsAttribute("hello-world"); | |
130 document().documentElement()->appendChild(elementA); | |
131 elementA->appendChild(elementB); | |
132 elementA->appendChild(elementC); | |
133 | |
134 registry().addCandidate(elementA); | |
135 registry().addCandidate(elementB); | |
136 registry().addCandidate(elementC); | |
137 | |
138 HeapVector<Member<Element>> elements; | |
139 collectCandidates(descriptor, &elements); | |
140 | |
141 EXPECT_EQ(1u, elements.size()) | |
142 << "only one candidates should have been found"; | |
143 EXPECT_EQ(elementB, elements[0]) | |
144 << "the matching element should have been found"; | |
145 } | |
146 | |
147 TEST_F(CustomElementsRegistryTest, collectCandidates_oneCandidate) | |
148 { | |
149 Element* element = CreateElement("a-a").inDocument(&document()); | |
150 registry().addCandidate(element); | |
151 document().documentElement()->appendChild(element); | |
152 | |
153 HeapVector<Member<Element>> elements; | |
154 collectCandidates( | |
155 CustomElementDescriptor("a-a", "a-a"), | |
156 &elements); | |
157 | |
158 EXPECT_EQ(1u, elements.size()) | |
159 << "exactly one candidate should have been found"; | |
160 EXPECT_TRUE(elements.contains(element)) | |
161 << "the candidate should be the element that was added"; | |
162 } | |
163 | |
164 TEST_F(CustomElementsRegistryTest, collectCandidates_shouldBeInDocumentOrder) | |
165 { | |
166 CreateElement factory = CreateElement("a-a"); | |
167 factory.inDocument(&document()); | |
168 Element* elementA = factory.withId("a"); | |
169 Element* elementB = factory.withId("b"); | |
170 Element* elementC = factory.withId("c"); | |
171 | |
172 registry().addCandidate(elementB); | |
173 registry().addCandidate(elementA); | |
174 registry().addCandidate(elementC); | |
175 | |
176 document().documentElement()->appendChild(elementA); | |
177 elementA->appendChild(elementB); | |
178 document().documentElement()->appendChild(elementC); | |
179 | |
180 HeapVector<Member<Element>> elements; | |
181 collectCandidates( | |
182 CustomElementDescriptor("a-a", "a-a"), | |
183 &elements); | |
184 | |
185 EXPECT_EQ(elementA, elements[0].get()); | |
186 EXPECT_EQ(elementB, elements[1].get()); | |
187 EXPECT_EQ(elementC, elements[2].get()); | |
188 } | |
189 | |
190 class TestCustomElementDefinition : public CustomElementDefinition { | |
191 WTF_MAKE_NONCOPYABLE(TestCustomElementDefinition); | |
192 public: | |
193 TestCustomElementDefinition(const CustomElementDescriptor& descriptor) | |
194 : CustomElementDefinition(descriptor) | |
195 { | |
196 } | |
197 | |
198 TestCustomElementDefinition(const CustomElementDescriptor& descriptor, | |
199 const HashSet<AtomicString>& observedAttributes) | |
200 : CustomElementDefinition(descriptor, observedAttributes) | |
201 { | |
202 } | |
203 | |
204 ~TestCustomElementDefinition() override = default; | |
205 | |
206 ScriptValue getConstructorForScript() override | |
207 { | |
208 return ScriptValue(); | |
209 } | |
210 | |
211 bool runConstructor(Element* element) override | |
212 { | |
213 if (constructionStack().isEmpty() | |
214 || constructionStack().last() != element) | |
215 return false; | |
216 constructionStack().last().clear(); | |
217 return true; | |
218 } | |
219 | |
220 HTMLElement* createElementSync(Document&, const QualifiedName&) override | |
221 { | |
222 return nullptr; | |
223 } | |
224 | |
225 HTMLElement* createElementSync(Document&, const QualifiedName&, ExceptionSta
te&) override | |
226 { | |
227 return nullptr; | |
228 } | |
229 }; | |
230 | |
231 // Classes which use trace macros cannot be local because of the | |
232 // traceImpl template. | |
233 class LogUpgradeDefinition : public TestCustomElementDefinition { | |
234 WTF_MAKE_NONCOPYABLE(LogUpgradeDefinition); | |
235 public: | |
236 LogUpgradeDefinition(const CustomElementDescriptor& descriptor) | |
237 : TestCustomElementDefinition(descriptor, { | |
238 "attr1", | |
239 "attr2", | |
240 HTMLNames::contenteditableAttr.localName(), | |
241 }) | |
242 { | |
243 } | |
244 | |
245 DEFINE_INLINE_VIRTUAL_TRACE() | |
246 { | |
247 TestCustomElementDefinition::trace(visitor); | |
248 visitor->trace(m_element); | |
249 } | |
250 | |
251 // TODO(dominicc): Make this class collect a vector of what's | |
252 // upgraded; it will be useful in more tests. | |
253 Member<Element> m_element; | |
254 enum MethodType { | |
255 Constructor, | |
256 ConnectedCallback, | |
257 DisconnectedCallback, | |
258 AdoptedCallback, | |
259 AttributeChangedCallback, | |
260 }; | |
261 Vector<MethodType> m_logs; | |
262 | |
263 struct AttributeChanged { | |
264 QualifiedName name; | |
265 AtomicString oldValue; | |
266 AtomicString newValue; | |
267 }; | |
268 Vector<AttributeChanged> m_attributeChanged; | |
269 | |
270 void clear() | |
271 { | |
272 m_logs.clear(); | |
273 m_attributeChanged.clear(); | |
274 } | |
275 | |
276 bool runConstructor(Element* element) override | |
277 { | |
278 m_logs.append(Constructor); | |
279 m_element = element; | |
280 return TestCustomElementDefinition::runConstructor(element); | |
281 } | |
282 | |
283 bool hasConnectedCallback() const override { return true; } | |
284 bool hasDisconnectedCallback() const override { return true; } | |
285 bool hasAdoptedCallback() const override {return true;} | |
286 | |
287 void runConnectedCallback(Element* element) override | |
288 { | |
289 m_logs.append(ConnectedCallback); | |
290 EXPECT_EQ(element, m_element); | |
291 } | |
292 | |
293 void runDisconnectedCallback(Element* element) override | |
294 { | |
295 m_logs.append(DisconnectedCallback); | |
296 EXPECT_EQ(element, m_element); | |
297 } | |
298 | |
299 void runAdoptedCallback(Element* element) override | |
300 { | |
301 m_logs.append(AdoptedCallback); | |
302 EXPECT_EQ(element, m_element); | |
303 } | |
304 | |
305 void runAttributeChangedCallback(Element* element, const QualifiedName& name
, const AtomicString& oldValue, const AtomicString& newValue) override | |
306 { | |
307 m_logs.append(AttributeChangedCallback); | |
308 EXPECT_EQ(element, m_element); | |
309 m_attributeChanged.append(AttributeChanged { name, oldValue, newValue })
; | |
310 } | |
311 }; | |
312 | |
313 class LogUpgradeBuilder final : public CustomElementDefinitionBuilder { | |
314 STACK_ALLOCATED(); | |
315 WTF_MAKE_NONCOPYABLE(LogUpgradeBuilder); | |
316 public: | |
317 LogUpgradeBuilder() { } | |
318 | |
319 bool checkConstructorIntrinsics() override { return true; } | |
320 bool checkConstructorNotRegistered() override { return true; } | |
321 bool checkPrototype() override { return true; } | |
322 bool rememberOriginalProperties() override { return true; } | |
323 CustomElementDefinition* build( | |
324 const CustomElementDescriptor& descriptor) { | |
325 return new LogUpgradeDefinition(descriptor); | |
326 } | |
327 }; | |
328 | |
329 TEST_F(CustomElementsRegistryTest, define_upgradesInDocumentElements) | |
330 { | |
331 ScriptForbiddenScope doNotRelyOnScript; | |
332 | |
333 Element* element = CreateElement("a-a").inDocument(&document()); | |
334 element->setAttribute(QualifiedName(nullAtom, "attr1", HTMLNames::xhtmlNames
paceURI), "v1"); | |
335 element->setBooleanAttribute(HTMLNames::contenteditableAttr, true); | |
336 document().documentElement()->appendChild(element); | |
337 | |
338 LogUpgradeBuilder builder; | |
339 NonThrowableExceptionState shouldNotThrow; | |
340 { | |
341 CEReactionsScope reactions; | |
342 registry().define( | |
343 "a-a", | |
344 builder, | |
345 ElementRegistrationOptions(), | |
346 shouldNotThrow); | |
347 } | |
348 LogUpgradeDefinition* definition = | |
349 static_cast<LogUpgradeDefinition*>(registry().definitionForName("a-a")); | |
350 EXPECT_EQ(LogUpgradeDefinition::Constructor, definition->m_logs[0]) | |
351 << "defining the element should have 'upgraded' the existing element"; | |
352 EXPECT_EQ(element, definition->m_element) | |
353 << "the existing a-a element should have been upgraded"; | |
354 | |
355 EXPECT_EQ(LogUpgradeDefinition::AttributeChangedCallback, definition->m_logs
[1]) | |
356 << "Upgrade should invoke attributeChangedCallback for all attributes"; | |
357 EXPECT_EQ("attr1", definition->m_attributeChanged[0].name); | |
358 EXPECT_EQ(nullAtom, definition->m_attributeChanged[0].oldValue); | |
359 EXPECT_EQ("v1", definition->m_attributeChanged[0].newValue); | |
360 | |
361 EXPECT_EQ(LogUpgradeDefinition::AttributeChangedCallback, definition->m_logs
[2]) | |
362 << "Upgrade should invoke attributeChangedCallback for all attributes"; | |
363 EXPECT_EQ("contenteditable", definition->m_attributeChanged[1].name); | |
364 EXPECT_EQ(nullAtom, definition->m_attributeChanged[1].oldValue); | |
365 EXPECT_EQ(emptyAtom, definition->m_attributeChanged[1].newValue); | |
366 EXPECT_EQ(2u, definition->m_attributeChanged.size()) | |
367 << "Upgrade should invoke attributeChangedCallback for all attributes"; | |
368 | |
369 EXPECT_EQ(LogUpgradeDefinition::ConnectedCallback, definition->m_logs[3]) | |
370 << "upgrade should invoke connectedCallback"; | |
371 | |
372 EXPECT_EQ(4u, definition->m_logs.size()) | |
373 << "upgrade should not invoke other callbacks"; | |
374 } | |
375 | |
376 TEST_F(CustomElementsRegistryTest, attributeChangedCallback) | |
377 { | |
378 ScriptForbiddenScope doNotRelyOnScript; | |
379 | |
380 Element* element = CreateElement("a-a").inDocument(&document()); | |
381 document().documentElement()->appendChild(element); | |
382 | |
383 LogUpgradeBuilder builder; | |
384 NonThrowableExceptionState shouldNotThrow; | |
385 { | |
386 CEReactionsScope reactions; | |
387 registry().define( | |
388 "a-a", | |
389 builder, | |
390 ElementRegistrationOptions(), | |
391 shouldNotThrow); | |
392 } | |
393 LogUpgradeDefinition* definition = | |
394 static_cast<LogUpgradeDefinition*>(registry().definitionForName("a-a")); | |
395 | |
396 definition->clear(); | |
397 { | |
398 CEReactionsScope reactions; | |
399 element->setAttribute(QualifiedName(nullAtom, "attr2", HTMLNames::xhtmlN
amespaceURI), "v2"); | |
400 } | |
401 EXPECT_EQ(LogUpgradeDefinition::AttributeChangedCallback, definition->m_logs
[0]) | |
402 << "Adding an attribute should invoke attributeChangedCallback"; | |
403 EXPECT_EQ(1u, definition->m_attributeChanged.size()) | |
404 << "Adding an attribute should invoke attributeChangedCallback"; | |
405 EXPECT_EQ("attr2", definition->m_attributeChanged[0].name); | |
406 EXPECT_EQ(nullAtom, definition->m_attributeChanged[0].oldValue); | |
407 EXPECT_EQ("v2", definition->m_attributeChanged[0].newValue); | |
408 | |
409 EXPECT_EQ(1u, definition->m_logs.size()) | |
410 << "upgrade should not invoke other callbacks"; | |
411 } | |
412 | |
413 TEST_F(CustomElementsRegistryTest, disconnectedCallback) | |
414 { | |
415 ScriptForbiddenScope doNotRelyOnScript; | |
416 | |
417 Element* element = CreateElement("a-a").inDocument(&document()); | |
418 document().documentElement()->appendChild(element); | |
419 | |
420 LogUpgradeBuilder builder; | |
421 NonThrowableExceptionState shouldNotThrow; | |
422 { | |
423 CEReactionsScope reactions; | |
424 registry().define( | |
425 "a-a", | |
426 builder, | |
427 ElementRegistrationOptions(), | |
428 shouldNotThrow); | |
429 } | |
430 LogUpgradeDefinition* definition = | |
431 static_cast<LogUpgradeDefinition*>(registry().definitionForName("a-a")); | |
432 | |
433 definition->clear(); | |
434 { | |
435 CEReactionsScope reactions; | |
436 element->remove(shouldNotThrow); | |
437 } | |
438 EXPECT_EQ(LogUpgradeDefinition::DisconnectedCallback, definition->m_logs[0]) | |
439 << "remove() should invoke disconnectedCallback"; | |
440 | |
441 EXPECT_EQ(1u, definition->m_logs.size()) | |
442 << "remove() should not invoke other callbacks"; | |
443 } | |
444 | |
445 TEST_F(CustomElementsRegistryTest, adoptedCallback) | |
446 { | |
447 ScriptForbiddenScope doNotRelyOnScript; | |
448 | |
449 Element* element = CreateElement("a-a").inDocument(&document()); | |
450 document().documentElement()->appendChild(element); | |
451 | |
452 LogUpgradeBuilder builder; | |
453 NonThrowableExceptionState shouldNotThrow; | |
454 { | |
455 CEReactionsScope reactions; | |
456 registry().define( | |
457 "a-a", | |
458 builder, | |
459 ElementRegistrationOptions(), | |
460 shouldNotThrow); | |
461 } | |
462 LogUpgradeDefinition* definition = | |
463 static_cast<LogUpgradeDefinition*>(registry().definitionForName("a-a")); | |
464 | |
465 definition->clear(); | |
466 Document* otherDocument = HTMLDocument::create(); | |
467 { | |
468 CEReactionsScope reactions; | |
469 otherDocument->adoptNode(element, ASSERT_NO_EXCEPTION); | |
470 } | |
471 EXPECT_EQ(LogUpgradeDefinition::DisconnectedCallback, definition->m_logs[0]) | |
472 << "adoptNode() should invoke disconnectedCallback"; | |
473 | |
474 EXPECT_EQ(LogUpgradeDefinition::AdoptedCallback, definition->m_logs[1]) | |
475 << "adoptNode() should invoke adoptedCallback"; | |
476 | |
477 EXPECT_EQ(2u, definition->m_logs.size()) | |
478 << "adoptNode() should not invoke other callbacks"; | |
479 } | |
480 | |
481 // TODO(dominicc): Add tests which adjust the "is" attribute when type | |
482 // extensions are implemented. | |
483 | |
484 } // namespace blink | |
OLD | NEW |