Stop using string-based enumerations in TextTrack, and eliminate support for string...
[WebKit-https.git] / Source / WebCore / bindings / scripts / CodeGeneratorJS.pm
1 #
2 # Copyright (C) 2005, 2006, 2007, 2008 Nikolas Zimmermann <zimmermann@kde.org>
3 # Copyright (C) 2006 Anders Carlsson <andersca@mac.com>
4 # Copyright (C) 2006, 2007 Samuel Weinig <sam@webkit.org>
5 # Copyright (C) 2006 Alexey Proskuryakov <ap@webkit.org>
6 # Copyright (C) 2006, 2007-2010, 2013-2016 Apple Inc. All rights reserved.
7 # Copyright (C) 2009 Cameron McCormack <cam@mcc.id.au>
8 # Copyright (C) Research In Motion Limited 2010. All rights reserved.
9 # Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies)
10 # Copyright (C) 2011 Patrick Gansterer <paroga@webkit.org>
11 # Copyright (C) 2012 Ericsson AB. All rights reserved.
12 # Copyright (C) 2007, 2008, 2009, 2012 Google Inc.
13 # Copyright (C) 2013 Samsung Electronics. All rights reserved.
14 # Copyright (C) 2015, 2016 Canon Inc. All rights reserved.
15 #
16 # This library is free software; you can redistribute it and/or
17 # modify it under the terms of the GNU Library General Public
18 # License as published by the Free Software Foundation; either
19 # version 2 of the License, or (at your option) any later version.
20 #
21 # This library is distributed in the hope that it will be useful,
22 # but WITHOUT ANY WARRANTY; without even the implied warranty of
23 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
24 # Library General Public License for more details.
25 #
26 # You should have received a copy of the GNU Library General Public License
27 # along with this library; see the file COPYING.LIB.  If not, write to
28 # the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
29 # Boston, MA 02110-1301, USA.
30
31
32 package CodeGeneratorJS;
33
34 use strict;
35 use constant FileNamePrefix => "JS";
36 use Hasher;
37
38 my $codeGenerator;
39
40 my @headerContentHeader = ();
41 my @headerContent = ();
42 my %headerIncludes = ();
43 my %headerTrailingIncludes = ();
44
45 my @implContentHeader = ();
46 my @implContent = ();
47 my %implIncludes = ();
48 my @depsContent = ();
49 my $numCachedAttributes = 0;
50 my $currentCachedAttribute = 0;
51
52 my $beginAppleCopyrightForHeaderFiles = <<END;
53 // ------- Begin Apple Copyright -------
54 /*
55  * Copyright (C) 2008, Apple Inc. All rights reserved.
56  *
57  * Permission is granted by Apple to use this file to the extent
58  * necessary to relink with LGPL WebKit files.
59  *
60  * No license or rights are granted by Apple expressly or by
61  * implication, estoppel, or otherwise, to Apple patents and
62  * trademarks. For the sake of clarity, no license or rights are
63  * granted by Apple expressly or by implication, estoppel, or otherwise,
64  * under any Apple patents, copyrights and trademarks to underlying
65  * implementations of any application programming interfaces (APIs)
66  * or to any functionality that is invoked by calling any API.
67  */
68
69 END
70 my $beginAppleCopyrightForSourceFiles = <<END;
71 // ------- Begin Apple Copyright -------
72 /*
73  * Copyright (C) 2008, Apple Inc. All rights reserved.
74  *
75  * No license or rights are granted by Apple expressly or by implication,
76  * estoppel, or otherwise, to Apple copyrights, patents, trademarks, trade
77  * secrets or other rights.
78  */
79
80 END
81 my $endAppleCopyright   = <<END;
82 // ------- End Apple Copyright   -------
83
84 END
85
86 # Default .h template
87 my $headerTemplate = << "EOF";
88 /*
89     This file is part of the WebKit open source project.
90     This file has been generated by generate-bindings.pl. DO NOT MODIFY!
91
92     This library is free software; you can redistribute it and/or
93     modify it under the terms of the GNU Library General Public
94     License as published by the Free Software Foundation; either
95     version 2 of the License, or (at your option) any later version.
96
97     This library is distributed in the hope that it will be useful,
98     but WITHOUT ANY WARRANTY; without even the implied warranty of
99     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
100     Library General Public License for more details.
101
102     You should have received a copy of the GNU Library General Public License
103     along with this library; see the file COPYING.LIB.  If not, write to
104     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
105     Boston, MA 02110-1301, USA.
106 */
107 EOF
108
109 # Default constructor
110 sub new
111 {
112     my $object = shift;
113     my $reference = { };
114
115     $codeGenerator = shift;
116
117     bless($reference, $object);
118     return $reference;
119 }
120
121 sub GenerateInterface
122 {
123     my $object = shift;
124     my $interface = shift;
125     my $defines = shift;
126     my $enumerations = shift;
127
128     $codeGenerator->LinkOverloadedFunctions($interface);
129
130     # Start actual generation
131     if ($interface->isCallback) {
132         $object->GenerateCallbackHeader($interface);
133         $object->GenerateCallbackImplementation($interface, $enumerations);
134     } else {
135         $object->GenerateHeader($interface);
136         $object->GenerateImplementation($interface, $enumerations);
137     }
138 }
139
140 sub EventHandlerAttributeEventName
141 {
142     my $attribute = shift;
143     my $eventType = $attribute->signature->extendedAttributes->{"ImplementedAs"} || $attribute->signature->name;
144
145     # Remove the "on" prefix.
146     $eventType = substr($eventType, 2);
147
148     return "eventNames().${eventType}Event";
149 }
150
151 sub GenerateEventListenerCall
152 {
153     my $functionName = shift;
154     my $suffix = ucfirst $functionName;
155     my $passRefPtrHandling = ($functionName eq "add") ? "" : ".ptr()";
156
157     $implIncludes{"JSEventListener.h"} = 1;
158
159     my @GenerateEventListenerImpl = ();
160
161     push(@GenerateEventListenerImpl, <<END);
162     JSValue listener = state->argument(1);
163     if (UNLIKELY(!listener.isObject()))
164         return JSValue::encode(jsUndefined());
165     impl.${functionName}EventListener(state->argument(0).toString(state)->toAtomicString(state), createJSEventListenerFor$suffix(*state, *asObject(listener), *castedThis)$passRefPtrHandling, state->argument(2).toBoolean(state));
166     return JSValue::encode(jsUndefined());
167 END
168     return @GenerateEventListenerImpl;
169 }
170
171 sub GetParentClassName
172 {
173     my $interface = shift;
174
175     return $interface->extendedAttributes->{"JSLegacyParent"} if $interface->extendedAttributes->{"JSLegacyParent"};
176     return "JSDOMObject" unless NeedsImplementationClass($interface);
177     return "JSDOMWrapper<" . GetImplClassName($interface->name) . ">" unless $interface->parent;
178     return "JS" . $interface->parent;
179 }
180
181 sub GetCallbackClassName
182 {
183     my $className = shift;
184
185     return "JS$className";
186 }
187
188 sub GetJSCallbackDataType
189 {
190     my $callbackInterface = shift;
191
192     return $callbackInterface->extendedAttributes->{"IsWeakCallback"} ? "JSCallbackDataWeak" : "JSCallbackDataStrong";
193 }
194
195 sub AddIncludesForTypeInImpl
196 {
197     my $type = shift;
198     my $isCallback = @_ ? shift : 0;
199     
200     AddIncludesForType($type, $isCallback, \%implIncludes);
201 }
202
203 sub AddIncludesForTypeInHeader
204 {
205     my $type = shift;
206     my $isCallback = @_ ? shift : 0;
207     
208     AddIncludesForType($type, $isCallback, \%headerIncludes);
209 }
210
211 my %typesWithoutHeader = (
212     "Array" => 1,
213     "DOMString" => 1,
214     "DOMTimeStamp" => 1,
215     "any" => 1
216 );
217
218 sub SkipIncludeHeader
219 {
220     my $type = shift;
221
222     return 1 if $codeGenerator->SkipIncludeHeader($type);
223     return $typesWithoutHeader{$type};
224 }
225
226 sub GetExportMacroForJSClass
227 {
228     my $interface = shift;
229
230     return $interface->extendedAttributes->{"ExportMacro"} . " " if $interface->extendedAttributes->{"ExportMacro"};
231     return "";
232 }
233
234 sub AddIncludesForType
235 {
236     my $type = shift;
237     my $isCallback = shift;
238     my $includesRef = shift;
239
240     return if SkipIncludeHeader($type);
241     
242     # When we're finished with the one-file-per-class reorganization, we won't need these special cases.
243     if ($type eq "XPathNSResolver") {
244         $includesRef->{"JSXPathNSResolver.h"} = 1;
245         $includesRef->{"JSCustomXPathNSResolver.h"} = 1;
246     } elsif ($isCallback && $codeGenerator->IsWrapperType($type)) {
247         $includesRef->{"JS${type}.h"} = 1;
248     } elsif ($codeGenerator->GetArrayOrSequenceType($type)) {
249         my $arrayType = $codeGenerator->GetArrayType($type);
250         my $arrayOrSequenceType = $arrayType || $codeGenerator->GetSequenceType($type);
251         if ($arrayType eq "DOMString") {
252             $includesRef->{"JSDOMStringList.h"} = 1;
253             $includesRef->{"DOMStringList.h"} = 1;
254         } elsif ($codeGenerator->IsRefPtrType($arrayOrSequenceType)) {
255             $includesRef->{"JS${arrayOrSequenceType}.h"} = 1;
256             $includesRef->{"${arrayOrSequenceType}.h"} = 1;
257         }
258         $includesRef->{"<runtime/JSArray.h>"} = 1;
259     } else {
260         # default, include the same named file
261         $includesRef->{"${type}.h"} = 1;
262     }
263 }
264
265 sub AddToImplIncludes
266 {
267     my $header = shift;
268     my $conditional = shift;
269
270     if (not $conditional) {
271         $implIncludes{$header} = 1;
272     } elsif (not exists($implIncludes{$header})) {
273         $implIncludes{$header} = $conditional;
274     } else {
275         my $oldValue = $implIncludes{$header};
276         $implIncludes{$header} = "$oldValue|$conditional" if $oldValue ne 1;
277     }
278 }
279
280 sub IsReadonly
281 {
282     my $attribute = shift;
283     return $attribute->isReadOnly && !$attribute->signature->extendedAttributes->{"Replaceable"} && !$attribute->signature->extendedAttributes->{"PutForwards"};
284 }
285
286 sub AddClassForwardIfNeeded
287 {
288     my $interfaceName = shift;
289
290     if ($interfaceName eq "ScriptProfileNode") {
291         $headerIncludes{"<profiler/ProfileNode.h>"} = 1;
292         push(@headerContent, "typedef JSC::ProfileNode ScriptProfileNode;\n\n");
293         return;
294     }
295
296     # SVGAnimatedLength/Number/etc. are typedefs and should not be forward-declared as classes.
297     return if $codeGenerator->IsSVGAnimatedType($interfaceName);
298
299     return if $codeGenerator->IsTypedArrayType($interfaceName);
300
301     push(@headerContent, "class $interfaceName;\n\n");
302 }
303
304 sub GetGenerateIsReachable
305 {
306     my $interface = shift;
307     return $interface->extendedAttributes->{"GenerateIsReachable"};
308 }
309
310 sub GetCustomIsReachable
311 {
312     my $interface = shift;
313     return $interface->extendedAttributes->{"CustomIsReachable"};
314 }
315
316 sub IsDOMGlobalObject
317 {
318     my $interface = shift;
319     return $interface->name eq "DOMWindow" || $codeGenerator->InheritsInterface($interface, "WorkerGlobalScope") || $interface->name eq "TestGlobalObject";
320 }
321
322 sub GenerateGetOwnPropertySlotBody
323 {
324     my ($interface, $interfaceName, $className, $hasInstanceProperties, $inlined) = @_;
325
326     my $namespaceMaybe = ($inlined ? "JSC::" : "");
327     my $namedGetterFunction = GetNamedGetterFunction($interface);
328     my $indexedGetterFunction = GetIndexedGetterFunction($interface);
329
330     my @getOwnPropertySlotImpl = ();
331
332     my $ownPropertyCheck = sub {
333         if ($hasInstanceProperties) {
334             my $instanceFunctionCount = InstanceFunctionCount($interface);
335             # If there are functions on the instance, then call getStaticPropertySlot() instead of getStaticValueSlot().
336             my $staticPropertyGetFunction = $namespaceMaybe . ($instanceFunctionCount eq 0 ? "getStaticValueSlot" : "getStaticPropertySlot");
337             my $staticPropertyTable = $inlined ? "*info()->staticPropHashTable" : "${className}Table";
338             push(@getOwnPropertySlotImpl, "    if ($staticPropertyGetFunction<$className, Base>(state, ${staticPropertyTable}, thisObject, propertyName, slot))\n");
339         } else {
340             push(@getOwnPropertySlotImpl, "    if (Base::getOwnPropertySlot(thisObject, state, propertyName, slot))\n");
341         }
342         push(@getOwnPropertySlotImpl, "        return true;\n");
343     };
344
345     # FIXME: As per the Web IDL specification, the prototype check is supposed to skip "named properties objects":
346     # https://heycam.github.io/webidl/#dfn-named-property-visibility
347     # https://heycam.github.io/webidl/#dfn-named-properties-object
348     my $prototypeCheck = sub {
349         push(@getOwnPropertySlotImpl, "    ${namespaceMaybe}JSValue proto = thisObject->getPrototypeDirect();\n");
350         push(@getOwnPropertySlotImpl, "    if (proto.isObject() && jsCast<${namespaceMaybe}JSObject*>(proto)->hasProperty(state, propertyName))\n");
351         push(@getOwnPropertySlotImpl, "        return false;\n\n");
352     };
353
354     if ($indexedGetterFunction) {
355         push(@getOwnPropertySlotImpl, "    Optional<uint32_t> optionalIndex = parseIndex(propertyName);\n");
356
357         # If the item function returns a string then we let the TreatReturnedNullStringAs handle the cases
358         # where the index is out of range.
359         if ($indexedGetterFunction->signature->type eq "DOMString") {
360             push(@getOwnPropertySlotImpl, "    if (optionalIndex) {\n");
361         } else {
362             push(@getOwnPropertySlotImpl, "    if (optionalIndex && optionalIndex.value() < thisObject->wrapped().length()) {\n");
363         }
364         push(@getOwnPropertySlotImpl, "        unsigned index = optionalIndex.value();\n");
365         # Assume that if there's a setter, the index will be writable
366         if ($interface->extendedAttributes->{"CustomIndexedSetter"}) {
367             push(@getOwnPropertySlotImpl, "        unsigned attributes = ${namespaceMaybe}DontDelete;\n");
368         } else {
369             push(@getOwnPropertySlotImpl, "        unsigned attributes = ${namespaceMaybe}DontDelete | ${namespaceMaybe}ReadOnly;\n");
370         }
371         push(@getOwnPropertySlotImpl, "        slot.setValue(thisObject, attributes, " . GetIndexedGetterExpression($indexedGetterFunction) . ");\n");
372         push(@getOwnPropertySlotImpl, "        return true;\n");
373         push(@getOwnPropertySlotImpl, "    }\n");
374     }
375
376     my $hasNamedGetter = $namedGetterFunction || $interface->extendedAttributes->{"CustomNamedGetter"};
377     if ($hasNamedGetter) {
378         if (!$interface->extendedAttributes->{"OverrideBuiltins"}) {
379             &$ownPropertyCheck();
380             &$prototypeCheck();
381         }
382
383         # The "thisObject->classInfo() == info()" check is to make sure we use the subclass' named getter
384         # instead of the base class one when possible.
385         if ($indexedGetterFunction) {
386             # Indexing an object with an integer that is not a supported property index should not call the named property getter.
387             # https://heycam.github.io/webidl/#idl-indexed-properties
388             push(@getOwnPropertySlotImpl, "    if (!optionalIndex && thisObject->classInfo() == info()) {\n");
389         } else {
390             push(@getOwnPropertySlotImpl, "    if (thisObject->classInfo() == info()) {\n");
391         }
392         push(@getOwnPropertySlotImpl, "        JSValue value;\n");
393         push(@getOwnPropertySlotImpl, "        if (thisObject->nameGetter(state, propertyName, value)) {\n");
394         push(@getOwnPropertySlotImpl, "            slot.setValue(thisObject, ReadOnly | DontDelete | DontEnum, value);\n");
395         push(@getOwnPropertySlotImpl, "            return true;\n");
396         push(@getOwnPropertySlotImpl, "        }\n");
397         push(@getOwnPropertySlotImpl, "    }\n");
398         if ($inlined) {
399             $headerIncludes{"wtf/text/AtomicString.h"} = 1;
400         } else {
401             $implIncludes{"wtf/text/AtomicString.h"} = 1;
402         }
403     }
404
405     if ($interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"}) {
406         push(@getOwnPropertySlotImpl, "    if (thisObject->getOwnPropertySlotDelegate(state, propertyName, slot))\n");
407         push(@getOwnPropertySlotImpl, "        return true;\n");
408     }
409
410     if (!$hasNamedGetter || $interface->extendedAttributes->{"OverrideBuiltins"}) {
411         &$ownPropertyCheck();
412     }
413
414     push(@getOwnPropertySlotImpl, "    return false;\n");
415
416     return @getOwnPropertySlotImpl;
417 }
418
419 sub GenerateHeaderContentHeader
420 {
421     my $interface = shift;
422     my $className = "JS" . $interface->name;
423
424     my @headerContentHeader;
425     if ($interface->extendedAttributes->{"AppleCopyright"}) {
426         @headerContentHeader = split("\r", $beginAppleCopyrightForHeaderFiles);
427     } else {
428         @headerContentHeader = split("\r", $headerTemplate);
429     }
430
431     push(@headerContentHeader, "\n#pragma once\n\n");
432
433     my $conditionalString = $codeGenerator->GenerateConditionalString($interface);
434     push(@headerContentHeader, "#if ${conditionalString}\n\n") if $conditionalString;
435     return @headerContentHeader;
436 }
437
438 sub GenerateImplementationContentHeader
439 {
440     my $interface = shift;
441     my $className = "JS" . $interface->name;
442
443     my @implContentHeader;
444     if ($interface->extendedAttributes->{"AppleCopyright"}) {
445         @implContentHeader = split("\r", $beginAppleCopyrightForSourceFiles);
446     } else {
447         @implContentHeader = split("\r", $headerTemplate);
448     }
449
450     push(@implContentHeader, "\n#include \"config.h\"\n");
451     my $conditionalString = $codeGenerator->GenerateConditionalString($interface);
452     push(@implContentHeader, "\n#if ${conditionalString}\n\n") if $conditionalString;
453     push(@implContentHeader, "#include \"$className.h\"\n\n");
454     return @implContentHeader;
455 }
456
457 sub NeedsImplementationClass
458 {
459     my ($interface) = @_;
460
461     return 0 if $interface->extendedAttributes->{"JSBuiltin"};
462     return 1;
463 }
464
465 sub ShouldGenerateToWrapped
466 {
467     my ($hasParent, $interface) = @_;
468
469     return 0 if not NeedsImplementationClass($interface);
470     return 1 if !$hasParent or $interface->extendedAttributes->{"JSGenerateToNativeObject"};
471     return 1 if $interface->parent && $interface->parent eq "EventTarget";
472     return 0;
473 }
474
475 sub ShouldGenerateWrapperOwnerCode
476 {
477     my ($hasParent, $interface) = @_;
478
479     return 0 if not NeedsImplementationClass($interface);
480     if (!$hasParent ||
481         GetGenerateIsReachable($interface) ||
482         GetCustomIsReachable($interface) ||
483         $interface->extendedAttributes->{"JSCustomFinalize"} ||
484         $codeGenerator->InheritsExtendedAttribute($interface, "ActiveDOMObject")) {
485         return 1;
486     }
487     return 0;
488 }
489
490 sub ShouldGenerateToJSDeclaration
491 {
492     my ($hasParent, $interface) = @_;
493
494     return 0 if ($interface->extendedAttributes->{"SuppressToJSObject"});
495     return 0 if not NeedsImplementationClass($interface);
496     return 0 if $interface->name eq "AbstractView";
497     return 0 if $interface->extendedAttributes->{"CustomProxyToJSObject"};
498     return 1 if (!$hasParent or $interface->extendedAttributes->{"JSGenerateToJSObject"} or $interface->extendedAttributes->{"CustomToJSObject"});
499     return 1 if $interface->parent && $interface->parent eq "EventTarget";
500     return 0;
501 }
502
503 sub ShouldGenerateToJSImplementation
504 {
505     my ($hasParent, $interface) = @_;
506
507     return 0 if not ShouldGenerateToJSDeclaration($hasParent, $interface);
508     return 1 if not $interface->extendedAttributes->{"CustomToJSObject"};
509     return 0;
510 }
511
512 sub GetAttributeGetterName
513 {
514     my ($interfaceName, $className, $interface, $attribute) = @_;
515     if ($attribute->isStatic) {
516         return $codeGenerator->WK_lcfirst($className) . "Constructor" . $codeGenerator->WK_ucfirst($attribute->signature->name);
517     }
518     if (IsJSBuiltin($interface, $attribute)) {
519         return GetJSBuiltinFunctionName($className, $attribute);
520     }
521     return "js" . $interfaceName . $codeGenerator->WK_ucfirst($attribute->signature->name) . ($attribute->signature->type =~ /Constructor$/ ? "Constructor" : "");
522 }
523
524 sub GetAttributeSetterName
525 {
526     my ($interfaceName, $className, $interface, $attribute) = @_;
527     if ($attribute->isStatic) {
528         return "set" . $codeGenerator->WK_ucfirst($className) . "Constructor" . $codeGenerator->WK_ucfirst($attribute->signature->name);
529     }
530     if (IsJSBuiltin($interface, $attribute)) {
531         return "set" . $codeGenerator->WK_ucfirst(GetJSBuiltinFunctionName($className, $attribute));
532     }
533     return "setJS" . $interfaceName . $codeGenerator->WK_ucfirst($attribute->signature->name) . ($attribute->signature->type =~ /Constructor$/ ? "Constructor" : "");
534 }
535
536 sub GetFunctionName
537 {
538     my ($interface, $className, $function) = @_;
539
540     if (IsJSBuiltin($interface, $function)) {
541         return GetJSBuiltinFunctionName($className, $function);
542     }
543
544     my $functionName = $function->signature->name;
545     $functionName = "SymbolIterator" if $functionName eq "[Symbol.Iterator]";
546
547     my $kind = $function->isStatic ? "Constructor" : (OperationShouldBeOnInstance($interface, $function) ? "Instance" : "Prototype");
548     return $codeGenerator->WK_lcfirst($className) . $kind . "Function" . $codeGenerator->WK_ucfirst($functionName);
549 }
550
551 sub GetSpecialAccessorFunctionForType
552 {
553     my $interface = shift;
554     my $special = shift;
555     my $firstParameterType = shift;
556     my $numberOfParameters = shift;
557
558     foreach my $function (@{$interface->functions}, @{$interface->anonymousFunctions}) {
559         my $specials = $function->signature->specials;
560         my $specialExists = grep { $_ eq $special } @$specials;
561         my $parameters = $function->parameters;
562         if ($specialExists and scalar(@$parameters) == $numberOfParameters and $parameters->[0]->type eq $firstParameterType) {
563             return $function;
564         }
565     }
566
567     return 0;
568 }
569
570 sub HasComplexGetOwnProperty
571 {
572     my $interface = shift;
573
574     my $namedGetterFunction = GetNamedGetterFunction($interface);
575     my $indexedGetterFunction = GetIndexedGetterFunction($interface);
576
577     my $hasNamedGetter = $namedGetterFunction || $interface->extendedAttributes->{"CustomNamedGetter"};
578
579     my $hasComplexGetter = $indexedGetterFunction
580         || $interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"}
581         || $interface->extendedAttributes->{"CustomGetOwnPropertySlot"}
582         || $hasNamedGetter;
583
584     return 1 if $interface->extendedAttributes->{"CheckSecurity"};
585     return 1 if IsDOMGlobalObject($interface);
586     return 1 if $hasComplexGetter;
587     return 0;
588 }
589
590
591 sub InterfaceRequiresAttributesOnInstanceForCompatibility
592 {
593     my $interface = shift;
594     my $interfaceName = $interface->name;
595
596     # Needed for compatibility with existing content
597     return 1 if $interfaceName =~ "Touch";
598     return 1 if $interfaceName =~ "ClientRect";
599
600     return 0;
601 }
602
603 sub InterfaceRequiresAttributesOnInstance
604 {
605     my $interface = shift;
606     my $interfaceName = $interface->name;
607
608     # FIXME: All these return 1 if ... should ideally be removed.
609     # Some of them are unavoidable due to DOM weirdness, in which case we should
610     # add an IDL attribute for them
611
612     # FIXME: We should be able to drop this once <rdar://problem/24466097> is fixed.
613     return 1 if $interface->isException;
614
615     return 1 if IsDOMGlobalObject($interface);
616
617     return 1 if InterfaceRequiresAttributesOnInstanceForCompatibility($interface);
618
619     return 0;
620 }
621
622 sub AttributeShouldBeOnInstanceForCompatibility
623 {
624     my $interface = shift;
625     my $attribute = shift;
626     my $interfaceName = $interface->name;
627     return 0;
628 }
629
630 sub AttributeShouldBeOnInstance
631 {
632     my $interface = shift;
633     my $attribute = shift;
634
635     # FIXME: The bindings generator does not support putting runtime-enabled attributes on the instance yet (except for global objects).
636     return 0 if $attribute->signature->extendedAttributes->{"EnabledAtRuntime"} && !IsDOMGlobalObject($interface);
637
638     return 1 if InterfaceRequiresAttributesOnInstance($interface);
639     return 1 if $attribute->signature->type =~ /Constructor$/;
640
641     # [Unforgeable] attributes should be on the instance.
642     # https://heycam.github.io/webidl/#Unforgeable
643     return 1 if IsUnforgeable($interface, $attribute);
644
645     return 1 if AttributeShouldBeOnInstanceForCompatibility($interface, $attribute);
646
647     if ($interface->extendedAttributes->{"CheckSecurity"}) {
648         if ($attribute->signature->extendedAttributes->{"DoNotCheckSecurity"} or
649             $attribute->signature->extendedAttributes->{"DoNotCheckSecurityOnGetter"}) {
650             return 0;
651         }
652         return 1;
653     }
654     return 0;
655 }
656
657 # https://heycam.github.io/webidl/#es-operations
658 sub OperationShouldBeOnInstance
659 {
660     my $interface = shift;
661     my $function = shift;
662
663     return 1 if IsDOMGlobalObject($interface);
664
665     # FIXME: The bindings generator does not support putting runtime-enabled operations on the instance yet (except for global objects).
666     return 0 if $function->signature->extendedAttributes->{"EnabledAtRuntime"};
667
668     # [Unforgeable] operations should be on the instance. https://heycam.github.io/webidl/#Unforgeable
669     return 1 if IsUnforgeable($interface, $function);
670
671     return 0;
672 }
673
674 sub GetJSCAttributesForAttribute
675 {
676     my $interface = shift;
677     my $attribute = shift;
678
679     my @specials = ();
680     push(@specials, "DontDelete") if IsUnforgeable($interface, $attribute);
681
682     # As per Web IDL specification, constructor properties on the ECMAScript global object should not be enumerable.
683     my $is_global_constructor = $attribute->signature->type =~ /Constructor$/;
684     push(@specials, "DontEnum") if ($attribute->signature->extendedAttributes->{"NotEnumerable"} || $is_global_constructor);
685     push(@specials, "ReadOnly") if IsReadonly($attribute);
686     push(@specials, "CustomAccessor") unless $is_global_constructor or IsJSBuiltin($interface, $attribute);
687     push(@specials, "Accessor | Builtin") if  IsJSBuiltin($interface, $attribute);
688     return (@specials > 0) ? join(" | ", @specials) : "0";
689 }
690
691 sub GetIndexedGetterFunction
692 {
693     my $interface = shift;
694     return GetSpecialAccessorFunctionForType($interface, "getter", "unsigned long", 1);
695 }
696
697 sub GetNamedGetterFunction
698 {
699     my $interface = shift;
700     return GetSpecialAccessorFunctionForType($interface, "getter", "DOMString", 1);
701 }
702
703 sub InstanceFunctionCount
704 {
705     my $interface = shift;
706     my $count = 0;
707
708     foreach my $function (@{$interface->functions}) {
709         $count++ if OperationShouldBeOnInstance($interface, $function);
710     }
711
712     return $count;
713 }
714
715 sub PrototypeFunctionCount
716 {
717     my $interface = shift;
718     my $count = 0;
719
720     foreach my $function (@{$interface->functions}) {
721         $count++ if !$function->isStatic && !OperationShouldBeOnInstance($interface, $function);
722     }
723
724     $count += scalar @{$interface->iterable->functions} if $interface->iterable;
725
726     return $count;
727 }
728
729 sub InstancePropertyCount
730 {
731     my $interface = shift;
732     my $count = 0;
733     foreach my $attribute (@{$interface->attributes}) {
734         $count++ if AttributeShouldBeOnInstance($interface, $attribute);
735     }
736     $count += InstanceFunctionCount($interface);
737     return $count;
738 }
739
740 sub PrototypePropertyCount
741 {
742     my $interface = shift;
743     my $count = 0;
744     foreach my $attribute (@{$interface->attributes}) {
745         $count++ if !AttributeShouldBeOnInstance($interface, $attribute);
746     }
747     $count += PrototypeFunctionCount($interface);
748     $count++ if NeedsConstructorProperty($interface);
749     return $count;
750 }
751
752 sub InstanceOverridesGetOwnPropertySlot
753 {
754     my $interface = shift;
755     my $numInstanceProperties = InstancePropertyCount($interface);
756
757     my $namedGetterFunction = GetNamedGetterFunction($interface);
758     my $indexedGetterFunction = GetIndexedGetterFunction($interface);
759
760     my $hasNamedGetter = $namedGetterFunction
761         || $interface->extendedAttributes->{"CustomNamedGetter"};
762
763     my $hasComplexGetter = $indexedGetterFunction
764         || $interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"}
765         || $interface->extendedAttributes->{"CustomGetOwnPropertySlot"}
766         || $hasNamedGetter;
767
768     return $numInstanceProperties > 0 || $hasComplexGetter;
769 }
770
771 sub PrototypeOverridesGetOwnPropertySlot
772 {
773     my $interface = shift;
774     my $numPrototypeProperties = PrototypePropertyCount($interface);
775     my $numConstants = @{$interface->constants};
776     return $numConstants > 0 || $numPrototypeProperties > 0;
777 }
778
779 sub InstanceOverridesPutImplementation
780 {
781     my $interface = shift;
782     return $interface->extendedAttributes->{"CustomNamedSetter"}
783         || $interface->extendedAttributes->{"CustomIndexedSetter"};
784 }
785
786 sub InstanceOverridesPutDeclaration
787 {
788     my $interface = shift;
789     return $interface->extendedAttributes->{"CustomPutFunction"}
790         || $interface->extendedAttributes->{"CustomNamedSetter"}
791         || $interface->extendedAttributes->{"CustomIndexedSetter"};
792 }
793
794 sub InstanceNeedsVisitChildren
795 {
796     my $interface = shift;
797     return $interface->extendedAttributes->{"JSCustomMarkFunction"}
798         || $codeGenerator->InheritsInterface($interface, "EventTarget")
799         || $interface->name eq "EventTarget"
800         || $interface->extendedAttributes->{"ReportExtraMemoryCost"}
801         || IsJSBuiltinConstructor($interface)
802 }
803
804 sub GetImplClassName
805 {
806     my $name = shift;
807
808     return "DOMWindow" if $name eq "AbstractView";
809
810     my ($svgPropertyType, $svgListPropertyType, $svgNativeType) = GetSVGPropertyTypes($name);
811     return $svgNativeType if $svgNativeType;
812
813     return $name;
814 }
815
816 sub GetEnumerationClassName
817 {
818     my ($name) = @_;
819     return $codeGenerator->WK_ucfirst($name);
820 };
821
822 sub GetEnumerationValueName
823 {
824     my ($name) = @_;
825     return "EmptyString" if $name eq "";
826     $name = join("", map { $codeGenerator->WK_ucfirst($_) } split("-", $name));
827     $name = "_$name" if $name =~ /^\d/;
828     return $name;
829 };
830
831 sub GetEnumerationImplementationContent
832 {
833     my ($enumerations) = @_;
834
835     # FIXME: Could optimize this to only generate things that are used, which would require
836     # iterating over everything in the interface.
837
838     my $result = "";
839     foreach my $enumeration (@$enumerations) {
840         my $name = $enumeration->name;
841
842         my $className = GetEnumerationClassName($name);
843
844         # FIXME: A little ugly to have this be a side effect instead of a return value.
845         AddToImplIncludes("<runtime/JSString.h>");
846
847         my $conditionalString = $codeGenerator->GenerateConditionalString($enumeration);
848         $result .= "#if ${conditionalString}\n\n" if $conditionalString;
849
850         # Declare these instead of using "static" because these may be unused and we don't
851         # want to get warnings about them.
852         $result .= "JSString* jsStringWithCache(ExecState*, $className);\n";
853         $result .= "Optional<$className> parse$className(ExecState&, JSValue);\n";
854         $result .= "extern const char expectedEnumerationValues${className}[];\n\n";
855
856         # Take an ExecState* instead of an ExecState& to match the jsStringWithCache from JSString.h.
857         # FIXME: Change to take VM& instead of ExecState*.
858         $result .= "JSString* jsStringWithCache(ExecState* state, $className enumerationValue)\n";
859         $result .= "{\n";
860         # FIXME: Might be nice to make this global be "const", but NeverDestroyed does not currently support that.
861         # FIXME: Might be nice to make the entire array be NeverDestroyed instead of each value, but not sure the syntax for that.
862         $result .= "    static NeverDestroyed<const String> values[] = {\n";
863         foreach my $value (@{$enumeration->values}) {
864             if ($value eq "") {
865                 $result .= "        emptyString(),\n";
866             } else {
867                 $result .= "        ASCIILiteral(\"$value\"),\n";
868             }
869         }
870         $result .= "    };\n";
871         my $index = 0;
872         foreach my $value (@{$enumeration->values}) {
873             my $enumerationValueName = GetEnumerationValueName($value);
874             $result .= "    static_assert(static_cast<size_t>(${className}::$enumerationValueName) == $index, \"${className}::$enumerationValueName is not $index as expected\");\n";
875             $index++;
876         }
877         $result .= "    ASSERT(static_cast<size_t>(enumerationValue) < WTF_ARRAY_LENGTH(values));\n";
878         $result .= "    return jsStringWithCache(state, values[static_cast<size_t>(enumerationValue)]);\n";
879         $result .= "}\n\n";
880
881         $result .= "template<> struct JSValueTraits<$className> {\n";
882         $result .= "    static JSString* arrayJSValue(ExecState* state, JSDOMGlobalObject*, $className value) { return jsStringWithCache(state, value); }\n";
883         $result .= "};\n\n";
884
885         # FIXME: Change to take VM& instead of ExecState&.
886         # FIXME: Consider using toStringOrNull to make exception checking faster.
887         # FIXME: Consider finding a more efficient way to match against all the strings quickly.
888         $result .= "Optional<$className> parse$className(ExecState& state, JSValue value)\n";
889         $result .= "{\n";
890         $result .= "    auto stringValue = value.toWTFString(&state);\n";
891         foreach my $value (@{$enumeration->values}) {
892             my $enumerationValueName = GetEnumerationValueName($value);
893             if ($value eq "") {
894                 $result .= "    if (stringValue.isEmpty())\n";
895             } else {
896                 $result .= "    if (stringValue == \"$value\")\n";
897             }
898             $result .= "        return ${className}::${enumerationValueName};\n";
899         }
900         $result .= "    return Nullopt;\n";
901         $result .= "}\n\n";
902
903         $result .= "const char expectedEnumerationValues${className}[] = \"\\\"" . join ("\\\", \\\"", @{$enumeration->values}) . "\\\"\";\n\n";
904
905         $result .= "#endif\n\n" if $conditionalString;
906     }
907     return $result;
908 }
909
910 sub GenerateHeader
911 {
912     my ($object, $interface) = @_;
913
914     my $interfaceName = $interface->name;
915     my $className = "JS$interfaceName";
916     my %structureFlags = ();
917
918     my $hasLegacyParent = $interface->extendedAttributes->{"JSLegacyParent"};
919     my $hasRealParent = $interface->parent;
920     my $hasParent = $hasLegacyParent || $hasRealParent;
921     my $parentClassName = GetParentClassName($interface);
922     my $needsVisitChildren = InstanceNeedsVisitChildren($interface);
923
924     # - Add default header template and header protection
925     push(@headerContentHeader, GenerateHeaderContentHeader($interface));
926
927     if ($hasParent) {
928         $headerIncludes{"$parentClassName.h"} = 1;
929     } else {
930         $headerIncludes{"JSDOMWrapper.h"} = 1;
931         if ($interface->isException) {
932             $headerIncludes{"<runtime/ErrorPrototype.h>"} = 1;
933         }
934     }
935
936     if ($interface->extendedAttributes->{"CustomCall"}) {
937         $headerIncludes{"<runtime/CallData.h>"} = 1;
938     }
939
940     if ($hasParent && $interface->extendedAttributes->{"JSGenerateToNativeObject"}) {
941         $headerIncludes{"$interfaceName.h"} = 1;
942     }
943     
944     $headerIncludes{"SVGElement.h"} = 1 if $className =~ /^JSSVG/;
945
946     my $implType = GetImplClassName($interfaceName);
947     my ($svgPropertyType, $svgListPropertyType, $svgNativeType) = GetSVGPropertyTypes($interfaceName);
948     my $svgPropertyOrListPropertyType;
949     $svgPropertyOrListPropertyType = $svgPropertyType if $svgPropertyType;
950     $svgPropertyOrListPropertyType = $svgListPropertyType if $svgListPropertyType;
951
952     my $numConstants = @{$interface->constants};
953     my $numAttributes = @{$interface->attributes};
954     my $numFunctions = @{$interface->functions};
955
956     push(@headerContent, "\nnamespace WebCore {\n\n");
957
958     if ($codeGenerator->IsSVGAnimatedType($interfaceName)) {
959         $headerIncludes{"$interfaceName.h"} = 1;
960     } else {
961         # Implementation class forward declaration
962         if (IsDOMGlobalObject($interface)) {
963             AddClassForwardIfNeeded($interfaceName) unless $svgPropertyOrListPropertyType;
964         }
965     }
966
967     AddClassForwardIfNeeded("JSDOMWindowShell") if $interfaceName eq "DOMWindow";
968     AddClassForwardIfNeeded("JSDictionary") if $codeGenerator->IsConstructorTemplate($interface, "Event");
969
970     my $exportMacro = GetExportMacroForJSClass($interface);
971
972     # Class declaration
973     push(@headerContent, "class $exportMacro$className : public $parentClassName {\n");
974
975     # Static create methods
976     push(@headerContent, "public:\n");
977     push(@headerContent, "    typedef $parentClassName Base;\n");
978     if ($interfaceName eq "DOMWindow") {
979         push(@headerContent, "    static $className* create(JSC::VM& vm, JSC::Structure* structure, Ref<$implType>&& impl, JSDOMWindowShell* windowShell)\n");
980         push(@headerContent, "    {\n");
981         push(@headerContent, "        $className* ptr = new (NotNull, JSC::allocateCell<$className>(vm.heap)) ${className}(vm, structure, WTFMove(impl), windowShell);\n");
982         push(@headerContent, "        ptr->finishCreation(vm, windowShell);\n");
983         push(@headerContent, "        vm.heap.addFinalizer(ptr, destroy);\n");
984         push(@headerContent, "        return ptr;\n");
985         push(@headerContent, "    }\n\n");
986     } elsif ($codeGenerator->InheritsInterface($interface, "WorkerGlobalScope")) {
987         push(@headerContent, "    static $className* create(JSC::VM& vm, JSC::Structure* structure, Ref<$implType>&& impl)\n");
988         push(@headerContent, "    {\n");
989         push(@headerContent, "        $className* ptr = new (NotNull, JSC::allocateCell<$className>(vm.heap)) ${className}(vm, structure, WTFMove(impl));\n");
990         push(@headerContent, "        ptr->finishCreation(vm);\n");
991         push(@headerContent, "        vm.heap.addFinalizer(ptr, destroy);\n");
992         push(@headerContent, "        return ptr;\n");
993         push(@headerContent, "    }\n\n");
994     } elsif ($interface->extendedAttributes->{"MasqueradesAsUndefined"}) {
995         AddIncludesForTypeInHeader($implType) unless $svgPropertyOrListPropertyType;
996         push(@headerContent, "    static $className* create(JSC::Structure* structure, JSDOMGlobalObject* globalObject, Ref<$implType>&& impl)\n");
997         push(@headerContent, "    {\n");
998         push(@headerContent, "        globalObject->masqueradesAsUndefinedWatchpoint()->fireAll(\"Allocated masquerading object\");\n");
999         push(@headerContent, "        $className* ptr = new (NotNull, JSC::allocateCell<$className>(globalObject->vm().heap)) $className(structure, *globalObject, WTFMove(impl));\n");
1000         push(@headerContent, "        ptr->finishCreation(globalObject->vm());\n");
1001         push(@headerContent, "        return ptr;\n");
1002         push(@headerContent, "    }\n\n");
1003     } elsif (!NeedsImplementationClass($interface)) {
1004         push(@headerContent, "    static $className* create(JSC::Structure* structure, JSDOMGlobalObject* globalObject)\n");
1005         push(@headerContent, "    {\n");
1006         push(@headerContent, "        $className* ptr = new (NotNull, JSC::allocateCell<$className>(globalObject->vm().heap)) $className(structure, *globalObject);\n");
1007         push(@headerContent, "        ptr->finishCreation(globalObject->vm());\n");
1008         push(@headerContent, "        return ptr;\n");
1009         push(@headerContent, "    }\n\n");  
1010     } else {
1011         AddIncludesForTypeInHeader($implType) unless $svgPropertyOrListPropertyType;
1012         push(@headerContent, "    static $className* create(JSC::Structure* structure, JSDOMGlobalObject* globalObject, Ref<$implType>&& impl)\n");
1013         push(@headerContent, "    {\n");
1014         push(@headerContent, "        $className* ptr = new (NotNull, JSC::allocateCell<$className>(globalObject->vm().heap)) $className(structure, *globalObject, WTFMove(impl));\n");
1015         push(@headerContent, "        ptr->finishCreation(globalObject->vm());\n");
1016         push(@headerContent, "        return ptr;\n");
1017         push(@headerContent, "    }\n\n");
1018     }
1019
1020     if (IsDOMGlobalObject($interface)) {
1021         push(@headerContent, "    static const bool needsDestruction = false;\n\n");
1022     }
1023
1024     my $hasStaticPropertyTable = InstancePropertyCount($interface) > 0 ? "true" : "false";
1025     push(@headerContent, "    static const bool hasStaticPropertyTable = $hasStaticPropertyTable;\n\n");
1026
1027     # Prototype
1028     unless (IsDOMGlobalObject($interface)) {
1029         push(@headerContent, "    static JSC::JSObject* createPrototype(JSC::VM&, JSC::JSGlobalObject*);\n");
1030         push(@headerContent, "    static JSC::JSObject* prototype(JSC::VM&, JSC::JSGlobalObject*);\n");
1031     }
1032
1033     # JSValue to implementation type
1034     if (ShouldGenerateToWrapped($hasParent, $interface)) {
1035         if ($interfaceName eq "NodeFilter") {
1036             push(@headerContent, "    static RefPtr<NodeFilter> toWrapped(JSC::VM&, JSC::JSValue);\n");
1037         } elsif ($interfaceName eq "DOMStringList") {
1038             push(@headerContent, "    static RefPtr<DOMStringList> toWrapped(JSC::ExecState*, JSC::JSValue);\n");
1039         } else {
1040             push(@headerContent, "    static $implType* toWrapped(JSC::JSValue);\n");
1041         }
1042     }
1043
1044     $headerTrailingIncludes{"${className}Custom.h"} = 1 if $interface->extendedAttributes->{"JSCustomHeader"};
1045
1046     my $namedGetterFunction = GetNamedGetterFunction($interface);
1047     my $indexedGetterFunction = GetIndexedGetterFunction($interface);
1048
1049     my $hasNamedGetter = $namedGetterFunction
1050         || $interface->extendedAttributes->{"CustomNamedGetter"};
1051
1052     my $hasComplexGetter =
1053         $indexedGetterFunction
1054         || $interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"}
1055         || $interface->extendedAttributes->{"CustomGetOwnPropertySlot"}
1056         || $hasNamedGetter;
1057     
1058     my $hasGetter = InstanceOverridesGetOwnPropertySlot($interface);
1059
1060     if ($hasNamedGetter) {
1061         if ($interface->extendedAttributes->{"OverrideBuiltins"}) {
1062             $structureFlags{"JSC::GetOwnPropertySlotIsImpure"} = 1;
1063         } else {
1064             $structureFlags{"JSC::GetOwnPropertySlotIsImpureForPropertyAbsence"} = 1;
1065         }
1066     }
1067     if ($interface->extendedAttributes->{"NewImpurePropertyFiresWatchpoints"}) {
1068         $structureFlags{"JSC::NewImpurePropertyFiresWatchpoints"} = 1;
1069     }
1070     if ($interface->extendedAttributes->{"CustomCall"}) {
1071         $structureFlags{"JSC::TypeOfShouldCallGetCallData"} = 1;
1072     }
1073
1074     # Getters
1075     if ($hasGetter) {
1076         push(@headerContent, "    static bool getOwnPropertySlot(JSC::JSObject*, JSC::ExecState*, JSC::PropertyName, JSC::PropertySlot&);\n");
1077         push(@headerContent, "    bool getOwnPropertySlotDelegate(JSC::ExecState*, JSC::PropertyName, JSC::PropertySlot&);\n") if $interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"};
1078         $structureFlags{"JSC::OverridesGetOwnPropertySlot"} = 1;
1079
1080         if ($hasComplexGetter) {
1081             push(@headerContent, "    static bool getOwnPropertySlotByIndex(JSC::JSObject*, JSC::ExecState*, unsigned propertyName, JSC::PropertySlot&);\n");
1082             $structureFlags{"JSC::InterceptsGetOwnPropertySlotByIndexEvenWhenLengthIsNotZero"} = 1;
1083         }
1084     }
1085
1086     my $overridesPut = InstanceOverridesPutDeclaration($interface);
1087
1088     # Getters
1089     if ($overridesPut) {
1090         push(@headerContent, "    static bool put(JSC::JSCell*, JSC::ExecState*, JSC::PropertyName, JSC::JSValue, JSC::PutPropertySlot&);\n");
1091         push(@headerContent, "    static bool putByIndex(JSC::JSCell*, JSC::ExecState*, unsigned propertyName, JSC::JSValue, bool shouldThrow);\n");
1092         push(@headerContent, "    bool putDelegate(JSC::ExecState*, JSC::PropertyName, JSC::JSValue, JSC::PutPropertySlot&, bool& putResult);\n") if $interface->extendedAttributes->{"CustomNamedSetter"};
1093     }
1094
1095     if (!$hasParent) {
1096         push(@headerContent, "    static void destroy(JSC::JSCell*);\n");
1097     }
1098
1099     # Class info
1100     if ($interfaceName eq "Node") {
1101         push(@headerContent, "\n");
1102         push(@headerContent, "protected:\n");
1103         push(@headerContent, "    static const JSC::ClassInfo s_info;\n");
1104         push(@headerContent, "public:\n");
1105         push(@headerContent, "    static const JSC::ClassInfo* info() { return &s_info; }\n\n");
1106     } else {
1107         push(@headerContent, "\n");
1108         push(@headerContent, "    DECLARE_INFO;\n\n");
1109     }
1110     # Structure ID
1111     if ($interfaceName eq "DOMWindow") {
1112         $structureFlags{"JSC::ImplementsHasInstance | JSC::ImplementsDefaultHasInstance"} = 1;
1113     }
1114     push(@headerContent, "    static JSC::Structure* createStructure(JSC::VM& vm, JSC::JSGlobalObject* globalObject, JSC::JSValue prototype)\n");
1115     push(@headerContent, "    {\n");
1116     if (IsDOMGlobalObject($interface)) {
1117         push(@headerContent, "        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::GlobalObjectType, StructureFlags), info());\n");
1118     } elsif ($codeGenerator->InheritsInterface($interface, "Document")) {
1119         push(@headerContent, "        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::JSType(JSDocumentWrapperType), StructureFlags), info());\n");
1120     } elsif ($codeGenerator->InheritsInterface($interface, "Element")) {
1121         push(@headerContent, "        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::JSType(JSElementType), StructureFlags), info());\n");
1122     } elsif ($codeGenerator->InheritsInterface($interface, "Node")) {
1123         push(@headerContent, "        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::JSType(JSNodeType), StructureFlags), info());\n");
1124     } else {
1125         push(@headerContent, "        return JSC::Structure::create(vm, globalObject, prototype, JSC::TypeInfo(JSC::ObjectType, StructureFlags), info());\n");
1126     }
1127     push(@headerContent, "    }\n\n");
1128
1129     # Custom pushEventHandlerScope function
1130     push(@headerContent, "    JSC::JSScope* pushEventHandlerScope(JSC::ExecState*, JSC::JSScope*) const;\n\n") if $interface->extendedAttributes->{"JSCustomPushEventHandlerScope"};
1131
1132     # Custom call functions
1133     push(@headerContent, "    static JSC::CallType getCallData(JSC::JSCell*, JSC::CallData&);\n\n") if $interface->extendedAttributes->{"CustomCall"};
1134
1135     # Custom deleteProperty function
1136     push(@headerContent, "    static bool deleteProperty(JSC::JSCell*, JSC::ExecState*, JSC::PropertyName);\n") if $interface->extendedAttributes->{"CustomDeleteProperty"};
1137     push(@headerContent, "    static bool deletePropertyByIndex(JSC::JSCell*, JSC::ExecState*, unsigned);\n") if $interface->extendedAttributes->{"CustomDeleteProperty"};
1138
1139     # Custom getPropertyNames function exists on DOMWindow
1140     if ($interfaceName eq "DOMWindow") {
1141         push(@headerContent, "    static void getPropertyNames(JSC::JSObject*, JSC::ExecState*, JSC::PropertyNameArray&, JSC::EnumerationMode = JSC::EnumerationMode());\n");
1142         push(@headerContent, "    static void getGenericPropertyNames(JSC::JSObject*, JSC::ExecState*, JSC::PropertyNameArray&, JSC::EnumerationMode = JSC::EnumerationMode());\n");
1143         push(@headerContent, "    static void getStructurePropertyNames(JSC::JSObject*, JSC::ExecState*, JSC::PropertyNameArray&, JSC::EnumerationMode = JSC::EnumerationMode());\n");
1144         push(@headerContent, "    static uint32_t getEnumerableLength(JSC::ExecState*, JSC::JSObject*);\n");
1145         $structureFlags{"JSC::OverridesGetPropertyNames"} = 1;
1146     }
1147
1148     # Custom getOwnPropertyNames function
1149     if ($interface->extendedAttributes->{"CustomEnumerateProperty"} || $indexedGetterFunction || $namedGetterFunction) {
1150         push(@headerContent, "    static void getOwnPropertyNames(JSC::JSObject*, JSC::ExecState*, JSC::PropertyNameArray&, JSC::EnumerationMode = JSC::EnumerationMode());\n");
1151         $structureFlags{"JSC::OverridesGetPropertyNames"} = 1;       
1152     }
1153
1154     # Custom defineOwnProperty function
1155     push(@headerContent, "    static bool defineOwnProperty(JSC::JSObject*, JSC::ExecState*, JSC::PropertyName, const JSC::PropertyDescriptor&, bool shouldThrow);\n") if $interface->extendedAttributes->{"JSCustomDefineOwnProperty"};
1156
1157     # Override toBoolean to return false for objects that want to 'MasqueradesAsUndefined'.
1158     if ($interface->extendedAttributes->{"MasqueradesAsUndefined"}) {
1159         $structureFlags{"JSC::MasqueradesAsUndefined"} = 1;
1160     }
1161
1162     # Constructor object getter
1163     unless ($interface->extendedAttributes->{"NoInterfaceObject"}) {
1164         push(@headerContent, "    static JSC::JSValue getConstructor(JSC::VM&, const JSC::JSGlobalObject*);\n");
1165         push(@headerContent, "    static JSC::JSValue getNamedConstructor(JSC::VM&, JSC::JSGlobalObject*);\n") if $interface->extendedAttributes->{"NamedConstructor"};
1166     }
1167
1168     my $numCustomFunctions = 0;
1169     my $numCustomAttributes = 0;
1170
1171     my $hasForwardDeclaringFunctions = 0;
1172     my $hasForwardDeclaringAttributes = 0;
1173
1174     # Attribute and function enums
1175     if ($numAttributes > 0) {
1176         foreach (@{$interface->attributes}) {
1177             my $attribute = $_;
1178             $numCustomAttributes++ if HasCustomGetter($attribute->signature->extendedAttributes);
1179             $numCustomAttributes++ if HasCustomSetter($attribute->signature->extendedAttributes);
1180             if ($attribute->signature->extendedAttributes->{"CachedAttribute"}) {
1181                 my $conditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
1182                 push(@headerContent, "#if ${conditionalString}\n") if $conditionalString;
1183                 push(@headerContent, "    mutable JSC::WriteBarrier<JSC::Unknown> m_" . $attribute->signature->name . ";\n");
1184                 $numCachedAttributes++;
1185                 $needsVisitChildren = 1;
1186                 push(@headerContent, "#endif\n") if $conditionalString;
1187             }
1188
1189             if ($attribute->signature->extendedAttributes->{"ForwardDeclareInHeader"}) {
1190                 $hasForwardDeclaringAttributes = 1;
1191             }
1192         }
1193     }
1194
1195     # visit function
1196     if ($needsVisitChildren) {
1197         push(@headerContent, "    static void visitChildren(JSCell*, JSC::SlotVisitor&);\n");
1198         push(@headerContent, "    void visitAdditionalChildren(JSC::SlotVisitor&);\n") if $interface->extendedAttributes->{"JSCustomMarkFunction"};
1199         push(@headerContent, "\n");
1200     }
1201
1202     if ($numCustomAttributes > 0) {
1203         push(@headerContent, "\n    // Custom attributes\n");
1204
1205         foreach my $attribute (@{$interface->attributes}) {
1206             my $conditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
1207             if (HasCustomGetter($attribute->signature->extendedAttributes)) {
1208                 push(@headerContent, "#if ${conditionalString}\n") if $conditionalString;
1209                 my $methodName = $codeGenerator->WK_lcfirst($attribute->signature->name);
1210                 push(@headerContent, "    JSC::JSValue " . $methodName . "(JSC::ExecState&) const;\n");
1211                 push(@headerContent, "#endif\n") if $conditionalString;
1212             }
1213             if (HasCustomSetter($attribute->signature->extendedAttributes) && !IsReadonly($attribute)) {
1214                 push(@headerContent, "#if ${conditionalString}\n") if $conditionalString;
1215                 push(@headerContent, "    void set" . $codeGenerator->WK_ucfirst($attribute->signature->name) . "(JSC::ExecState&, JSC::JSValue);\n");
1216                 push(@headerContent, "#endif\n") if $conditionalString;
1217             }
1218         }
1219     }
1220
1221     foreach my $function (@{$interface->functions}) {
1222         $numCustomFunctions++ if HasCustomMethod($function->signature->extendedAttributes);
1223
1224         if ($function->signature->extendedAttributes->{"ForwardDeclareInHeader"}) {
1225             $hasForwardDeclaringFunctions = 1;
1226         }
1227     }
1228
1229     if ($numCustomFunctions > 0) {
1230         my $inAppleCopyright = 0;
1231         push(@headerContent, "\n    // Custom functions\n");
1232         foreach my $function (@{$interface->functions}) {
1233             my $needsAppleCopyright = $function->signature->extendedAttributes->{"AppleCopyright"};
1234             if ($needsAppleCopyright) {
1235                 if (!$inAppleCopyright) {
1236                     push(@headerContent, $beginAppleCopyrightForHeaderFiles);
1237                     $inAppleCopyright = 1;
1238                 }
1239             } elsif ($inAppleCopyright) {
1240                 push(@headerContent, $endAppleCopyright);
1241                 $inAppleCopyright = 0;
1242             }
1243             next unless HasCustomMethod($function->signature->extendedAttributes);
1244             next if $function->{overloads} && $function->{overloadIndex} != 1;
1245             my $conditionalString = $codeGenerator->GenerateConditionalString($function->signature);
1246             push(@headerContent, "#if ${conditionalString}\n") if $conditionalString;
1247             my $functionImplementationName = $function->signature->extendedAttributes->{"ImplementedAs"} || $codeGenerator->WK_lcfirst($function->signature->name);
1248             push(@headerContent, "    " . ($function->isStatic ? "static " : "") . "JSC::JSValue " . $functionImplementationName . "(JSC::ExecState&);\n");
1249             push(@headerContent, "#endif\n") if $conditionalString;
1250         }
1251         push(@headerContent, $endAppleCopyright) if $inAppleCopyright;
1252     }
1253
1254     if (NeedsImplementationClass($interface)) {
1255         if ($hasParent) {
1256             push(@headerContent, "    $interfaceName& wrapped() const\n");
1257             push(@headerContent, "    {\n");
1258             push(@headerContent, "        return static_cast<$interfaceName&>(Base::wrapped());\n");
1259             push(@headerContent, "    }\n");
1260         }
1261     }
1262
1263     # structure flags
1264     if (%structureFlags) {
1265         push(@headerContent, "public:\n");
1266         push(@headerContent, "    static const unsigned StructureFlags = ");
1267         foreach my $structureFlag (sort (keys %structureFlags)) {
1268             push(@headerContent, $structureFlag . " | ");
1269         }
1270         push(@headerContent, "Base::StructureFlags;\n");
1271     }
1272
1273     push(@headerContent, "protected:\n");
1274
1275     # Constructor
1276     if ($interfaceName eq "DOMWindow") {
1277         push(@headerContent, "    $className(JSC::VM&, JSC::Structure*, Ref<$implType>&&, JSDOMWindowShell*);\n");
1278     } elsif ($codeGenerator->InheritsInterface($interface, "WorkerGlobalScope")) {
1279         push(@headerContent, "    $className(JSC::VM&, JSC::Structure*, Ref<$implType>&&);\n");
1280     } elsif (!NeedsImplementationClass($interface)) {
1281         push(@headerContent, "    $className(JSC::Structure*, JSDOMGlobalObject&);\n\n");
1282      } else {
1283         push(@headerContent, "    $className(JSC::Structure*, JSDOMGlobalObject&, Ref<$implType>&&);\n\n");
1284         push(@headerContent, "    void finishCreation(JSC::VM& vm)\n");
1285         push(@headerContent, "    {\n");
1286         push(@headerContent, "        Base::finishCreation(vm);\n");
1287         push(@headerContent, "        ASSERT(inherits(info()));\n");
1288         push(@headerContent, "    }\n\n");
1289     }
1290
1291     if (IsDOMGlobalObject($interface)) {
1292         if ($interfaceName eq "DOMWindow") {
1293             push(@headerContent, "    void finishCreation(JSC::VM&, JSDOMWindowShell*);\n");
1294         } else {
1295             push(@headerContent, "    void finishCreation(JSC::VM&);\n");
1296         }
1297     }
1298
1299     # Index setter
1300     if ($interface->extendedAttributes->{"CustomIndexedSetter"}) {
1301         push(@headerContent, "    void indexSetter(JSC::ExecState*, unsigned index, JSC::JSValue);\n");
1302     }
1303     # Name getter
1304     if ($namedGetterFunction || $interface->extendedAttributes->{"CustomNamedGetter"}) {
1305         push(@headerContent, "private:\n");
1306         push(@headerContent, "    bool nameGetter(JSC::ExecState*, JSC::PropertyName, JSC::JSValue&);\n");
1307     }
1308
1309     push(@headerContent, "};\n\n");
1310
1311     if (ShouldGenerateWrapperOwnerCode($hasParent, $interface)) {
1312         if ($interfaceName ne "Node" && $codeGenerator->InheritsInterface($interface, "Node")) {
1313             $headerIncludes{"JSNode.h"} = 1;
1314             push(@headerContent, "class JS${interfaceName}Owner : public JSNodeOwner {\n");
1315         } else {
1316             push(@headerContent, "class JS${interfaceName}Owner : public JSC::WeakHandleOwner {\n");
1317         }
1318         $headerIncludes{"<wtf/NeverDestroyed.h>"} = 1;
1319         push(@headerContent, "public:\n");
1320         push(@headerContent, "    virtual bool isReachableFromOpaqueRoots(JSC::Handle<JSC::Unknown>, void* context, JSC::SlotVisitor&);\n");
1321         push(@headerContent, "    virtual void finalize(JSC::Handle<JSC::Unknown>, void* context);\n");
1322         push(@headerContent, "};\n");
1323         push(@headerContent, "\n");
1324         push(@headerContent, "inline JSC::WeakHandleOwner* wrapperOwner(DOMWrapperWorld&, $implType*)\n");
1325         push(@headerContent, "{\n");
1326         push(@headerContent, "    static NeverDestroyed<JS${interfaceName}Owner> owner;\n");
1327         push(@headerContent, "    return &owner.get();\n");
1328         push(@headerContent, "}\n");
1329         push(@headerContent, "\n");
1330         push(@headerContent, "inline void* wrapperKey($implType* wrappableObject)\n");
1331         push(@headerContent, "{\n");
1332         push(@headerContent, "    return wrappableObject;\n");
1333         push(@headerContent, "}\n");
1334         push(@headerContent, "\n");
1335     }
1336     if (ShouldGenerateToJSDeclaration($hasParent, $interface)) {
1337         # Node and NodeList have custom inline implementations which thus cannot be exported.
1338         # FIXME: The special case for Node and NodeList should probably be implemented via an IDL attribute.
1339         if ($implType eq "Node" or $implType eq "NodeList") {
1340             push(@headerContent, "JSC::JSValue toJS(JSC::ExecState*, JSDOMGlobalObject*, $implType*);\n");
1341         } else {
1342             push(@headerContent, $exportMacro."JSC::JSValue toJS(JSC::ExecState*, JSDOMGlobalObject*, $implType*);\n");
1343         }
1344         push(@headerContent, "inline JSC::JSValue toJS(JSC::ExecState* state, JSDOMGlobalObject* globalObject, $implType& impl) { return toJS(state, globalObject, &impl); }\n");
1345
1346         push(@headerContent, "JSC::JSValue toJSNewlyCreated(JSC::ExecState*, JSDOMGlobalObject*, $implType*);\n");
1347     }
1348
1349     push(@headerContent, "\n");
1350
1351     # Add prototype declaration.
1352     if (HeaderNeedsPrototypeDeclaration($interface)) {
1353         GeneratePrototypeDeclaration(\@headerContent, $className, $interface, $interfaceName);
1354     }
1355
1356     if ($hasForwardDeclaringFunctions) {
1357         my $inAppleCopyright = 0;
1358         push(@headerContent,"// Functions\n\n");
1359         foreach my $function (@{$interface->functions}) {
1360             next if $function->{overloadIndex} && $function->{overloadIndex} > 1;
1361             next unless $function->signature->extendedAttributes->{"ForwardDeclareInHeader"};
1362
1363             my $needsAppleCopyright = $function->signature->extendedAttributes->{"AppleCopyright"};
1364             if ($needsAppleCopyright) {
1365                 if (!$inAppleCopyright) {
1366                     push(@headerContent, $beginAppleCopyrightForHeaderFiles);
1367                     $inAppleCopyright = 1;
1368                 }
1369             } elsif ($inAppleCopyright) {
1370                 push(@headerContent, $endAppleCopyright);
1371                 $inAppleCopyright = 0;
1372             }
1373
1374             my $conditionalString = $codeGenerator->GenerateConditionalString($function->signature);
1375             push(@headerContent, "#if ${conditionalString}\n") if $conditionalString;
1376             my $functionName = GetFunctionName($interface, $className, $function);
1377             push(@headerContent, "JSC::EncodedJSValue JSC_HOST_CALL ${functionName}(JSC::ExecState*);\n");
1378             push(@headerContent, "#endif\n") if $conditionalString;
1379         }
1380
1381         push(@headerContent, $endAppleCopyright) if $inAppleCopyright;
1382         push(@headerContent,"\n");
1383     }
1384
1385     if ($hasForwardDeclaringAttributes) {
1386         push(@headerContent,"// Attributes\n\n");
1387         foreach my $attribute (@{$interface->attributes}) {
1388             next unless $attribute->signature->extendedAttributes->{"ForwardDeclareInHeader"};
1389
1390             my $conditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
1391             push(@headerContent, "#if ${conditionalString}\n") if $conditionalString;
1392             my $getter = GetAttributeGetterName($interfaceName, $className, $interface, $attribute);
1393             push(@headerContent, "JSC::EncodedJSValue ${getter}(JSC::ExecState*, JSC::EncodedJSValue, JSC::PropertyName);\n");
1394             if (!IsReadonly($attribute)) {
1395                 my $setter = GetAttributeSetterName($interfaceName, $className, $interface, $attribute);
1396                 push(@headerContent, "bool ${setter}(JSC::ExecState*, JSC::EncodedJSValue, JSC::EncodedJSValue);\n");
1397             }
1398             push(@headerContent, "#endif\n") if $conditionalString;
1399         }
1400     }
1401
1402     if (HasCustomConstructor($interface)) {
1403         push(@headerContent, "// Custom constructor\n");
1404         push(@headerContent, "JSC::EncodedJSValue JSC_HOST_CALL construct${className}(JSC::ExecState*);\n\n");
1405     }
1406
1407     if ($codeGenerator->IsConstructorTemplate($interface, "Event")) {
1408         push(@headerContent, "bool fill${interfaceName}Init(${interfaceName}Init&, JSDictionary&);\n\n");
1409     }
1410
1411     my $conditionalString = $codeGenerator->GenerateConditionalString($interface);
1412     push(@headerContent, "\n} // namespace WebCore\n");
1413     push(@headerContent, "\n#endif // ${conditionalString}\n") if $conditionalString;
1414
1415     if ($interface->extendedAttributes->{"AppleCopyright"}) {
1416         push(@headerContent, "\n");
1417         push(@headerContent, split("\r", $endAppleCopyright));
1418     }
1419 }
1420
1421 sub GeneratePropertiesHashTable
1422 {
1423     my ($object, $interface, $isInstance, $hashKeys, $hashSpecials, $hashValue1, $hashValue2, $conditionals, $runtimeEnabledFunctions, $runtimeEnabledAttributes) = @_;
1424
1425     # FIXME: These should be functions on $interface.
1426     my $interfaceName = $interface->name;
1427     my $className = "JS$interfaceName";
1428     
1429     # - Add all properties in a hashtable definition
1430     my $propertyCount = $isInstance ? InstancePropertyCount($interface) : PrototypePropertyCount($interface);
1431
1432     if (!$isInstance && NeedsConstructorProperty($interface)) {
1433         die if !$propertyCount;
1434         push(@$hashKeys, "constructor");
1435         my $getter = "js" . $interfaceName . "Constructor";
1436         push(@$hashValue1, $getter);
1437
1438         my $setter = "setJS" . $interfaceName . "Constructor";
1439         push(@$hashValue2, $setter);
1440         push(@$hashSpecials, "DontEnum");
1441     }
1442
1443     return 0 if !$propertyCount;
1444
1445     foreach my $attribute (@{$interface->attributes}) {
1446         next if ($attribute->isStatic);
1447         next if AttributeShouldBeOnInstance($interface, $attribute) != $isInstance;
1448
1449         # Global objects add RuntimeEnabled attributes after creation so do not add them to the static table.
1450         if (IsDOMGlobalObject($interface) && $attribute->signature->extendedAttributes->{"EnabledAtRuntime"}) {
1451             $propertyCount -= 1;
1452             next;
1453         }
1454
1455         my $name = $attribute->signature->name;
1456         push(@$hashKeys, $name);
1457
1458         my $special = GetJSCAttributesForAttribute($interface, $attribute);
1459         push(@$hashSpecials, $special);
1460
1461         my $getter = GetAttributeGetterName($interfaceName, $className, $interface, $attribute);
1462         push(@$hashValue1, $getter);
1463
1464         if (IsReadonly($attribute)) {
1465             push(@$hashValue2, "0");
1466         } else {
1467             my $setter = GetAttributeSetterName($interfaceName, $className, $interface, $attribute);
1468             push(@$hashValue2, $setter);
1469         }
1470
1471         my $conditional = $attribute->signature->extendedAttributes->{"Conditional"};
1472         if ($conditional) {
1473             $conditionals->{$name} =  $conditional;
1474         }
1475
1476         if ($attribute->signature->extendedAttributes->{"EnabledAtRuntime"}) {
1477             if ($isInstance) {
1478                 die "We currently do not support [EnabledAtRuntime] attributes on the instance (except for global objects).";
1479             } else {
1480                 push(@$runtimeEnabledAttributes, $attribute);
1481             }
1482         }
1483     }
1484
1485     my @functions = @{$interface->functions};
1486     push(@functions, @{$interface->iterable->functions}) if $interface->iterable;
1487     foreach my $function (@functions) {
1488         next if ($function->signature->extendedAttributes->{"Private"});
1489         next if ($function->isStatic);
1490         next if $function->{overloadIndex} && $function->{overloadIndex} > 1;
1491         next if OperationShouldBeOnInstance($interface, $function) != $isInstance;
1492         next if $function->signature->name eq "[Symbol.Iterator]";
1493
1494         # Global objects add RuntimeEnabled operations after creation so do not add them to the static table.
1495         if (IsDOMGlobalObject($interface) && $function->signature->extendedAttributes->{"EnabledAtRuntime"}) {
1496             $propertyCount -= 1;
1497             next;
1498         }
1499
1500         my $name = $function->signature->name;
1501         push(@$hashKeys, $name);
1502
1503         my $functionName = GetFunctionName($interface, $className, $function);
1504         push(@$hashValue1, $functionName);
1505
1506         my $functionLength = GetFunctionLength($function);
1507         push(@$hashValue2, $functionLength);
1508
1509         push(@$hashSpecials, ComputeFunctionSpecial($interface, $function));
1510
1511         my $conditional = $function->signature->extendedAttributes->{"Conditional"};
1512         if ($conditional) {
1513             $conditionals->{$name} = $conditional;
1514         }
1515
1516         if ($function->signature->extendedAttributes->{"EnabledAtRuntime"}) {
1517             if ($isInstance) {
1518                 die "We currently do not support [EnabledAtRuntime] operations on the instance (except for global objects).";
1519             } else {
1520                 push(@$runtimeEnabledFunctions, $function);
1521             }
1522         }
1523     }
1524
1525     return $propertyCount;
1526 }
1527
1528 sub GenerateParametersCheckExpression
1529 {
1530     my $numParameters = shift;
1531     my $function = shift;
1532
1533     my @andExpression = ();
1534     push(@andExpression, "argsCount == $numParameters");
1535     my $parameterIndex = 0;
1536     my %usedArguments = ();
1537     foreach my $parameter (@{$function->parameters}) {
1538         last if $parameterIndex >= $numParameters;
1539         my $value = "arg$parameterIndex";
1540         my $type = $parameter->type;
1541
1542         # Only DOMString or wrapper types are checked.
1543         # For DOMString with StrictTypeChecking only Null, Undefined and Object
1544         # are accepted for compatibility. Otherwise, no restrictions are made to
1545         # match the non-overloaded behavior.
1546         # FIXME: Implement WebIDL overload resolution algorithm.
1547         if ($type eq "DOMString" || $codeGenerator->IsEnumType($type)) {
1548             if ($parameter->extendedAttributes->{"StrictTypeChecking"}) {
1549                 push(@andExpression, "(${value}.isUndefinedOrNull() || ${value}.isString() || ${value}.isObject())");
1550                 $usedArguments{$parameterIndex} = 1;
1551             }
1552         } elsif ($codeGenerator->IsCallbackInterface($parameter->type)) {
1553             # For Callbacks only checks if the value is null or object.
1554             if ($codeGenerator->IsFunctionOnlyCallbackInterface($parameter->type)) {
1555                 push(@andExpression, "(${value}.isNull() || ${value}.isFunction())");
1556             } else {
1557                 push(@andExpression, "(${value}.isNull() || ${value}.isObject())");
1558             }
1559             $usedArguments{$parameterIndex} = 1;
1560         } elsif (!IsNativeType($type)) {
1561             my $condition = "";
1562             $condition .= "${value}.isUndefined() || " if $parameter->isOptional;
1563
1564             # FIXME: WebIDL says that undefined is also acceptable for nullable parameters and
1565             # should be converted to null:
1566             # http://heycam.github.io/webidl/#es-nullable-type
1567             $condition .= "${value}.isNull() || " if $parameter->isNullable;
1568
1569             if ($codeGenerator->GetArrayOrSequenceType($type)) {
1570                 # FIXME: Add proper support for T[], T[]?, sequence<T>.
1571                 $condition .= "(${value}.isObject() && isJSArray(${value}))";
1572             } else {
1573                 $condition .= "(${value}.isObject() && asObject(${value})->inherits(JS${type}::info()))";
1574             }
1575             push(@andExpression, "(" . $condition . ")");
1576             $usedArguments{$parameterIndex} = 1;
1577         }
1578         $parameterIndex++;
1579     }
1580     my $res = join(" && ", @andExpression);
1581     $res = "($res)" if @andExpression > 1;
1582     return ($res, sort {$a <=> $b} (keys %usedArguments));
1583 }
1584
1585 # As per Web IDL specification, the length of a function Object is its number of mandatory parameters.
1586 sub GetFunctionLength
1587 {
1588     my $function = shift;
1589
1590     my $length = 0;
1591     foreach my $parameter (@{$function->parameters}) {
1592         # Abort as soon as we find the first optional parameter as no mandatory
1593         # parameter can follow an optional one.
1594         last if $parameter->isOptional || $parameter->isVariadic;
1595         $length++;
1596     }
1597     return $length;
1598 }
1599
1600 sub GenerateFunctionParametersCheck
1601 {
1602     my $function = shift;
1603
1604     my @orExpression = ();
1605     my $numParameters = 0;
1606     my @neededArguments = ();
1607     my $hasVariadic = 0;
1608     my $numMandatoryParams = @{$function->parameters};
1609
1610     foreach my $parameter (@{$function->parameters}) {
1611         if ($parameter->isOptional) {
1612             my ($expression, @usedArguments) = GenerateParametersCheckExpression($numParameters, $function);
1613             push(@orExpression, $expression);
1614             push(@neededArguments, @usedArguments);
1615             $numMandatoryParams--;
1616         }
1617         if ($parameter->isVariadic) {
1618             $hasVariadic = 1;
1619             last;
1620         }
1621         $numParameters++;
1622     }
1623     if (!$hasVariadic) {
1624         my ($expression, @usedArguments) = GenerateParametersCheckExpression($numParameters, $function);
1625         push(@orExpression, $expression);
1626         push(@neededArguments, @usedArguments);
1627     }
1628     return ($numMandatoryParams, join(" || ", @orExpression), @neededArguments);
1629 }
1630
1631 sub LengthOfLongestFunctionParameterList
1632 {
1633     my ($overloads) = @_;
1634     my $result = 0;
1635     foreach my $overload (@{$overloads}) {
1636         my @parameters = @{$overload->parameters};
1637         $result = @parameters if $result < @parameters;
1638     }
1639     return $result;
1640 }
1641
1642 sub GenerateOverloadedFunction
1643 {
1644     my $function = shift;
1645     my $interface = shift;
1646     my $interfaceName = shift;
1647
1648     # Generate code for choosing the correct overload to call. Overloads are
1649     # chosen based on the total number of arguments passed and the type of
1650     # values passed in non-primitive argument slots. When more than a single
1651     # overload is applicable, precedence is given according to the order of
1652     # declaration in the IDL.
1653
1654     my $kind = $function->isStatic ? "Constructor" : (OperationShouldBeOnInstance($interface, $function) ? "Instance" : "Prototype");
1655     my $functionName = "js${interfaceName}${kind}Function" . $codeGenerator->WK_ucfirst($function->signature->name);
1656
1657     # FIXME: Implement support for overloaded functions with variadic arguments.
1658     my $lengthOfLongestOverloadedFunctionParameterList = LengthOfLongestFunctionParameterList($function->{overloads});
1659
1660     push(@implContent, "EncodedJSValue JSC_HOST_CALL ${functionName}(ExecState* state)\n");
1661     push(@implContent, <<END);
1662 {
1663     size_t argsCount = std::min<size_t>($lengthOfLongestOverloadedFunctionParameterList, state->argumentCount());
1664 END
1665
1666     my %fetchedArguments = ();
1667     my $leastNumMandatoryParams = 255;
1668
1669     foreach my $overload (@{$function->{overloads}}) {
1670         my ($numMandatoryParams, $parametersCheck, @neededArguments) = GenerateFunctionParametersCheck($overload);
1671         $leastNumMandatoryParams = $numMandatoryParams if ($numMandatoryParams < $leastNumMandatoryParams);
1672
1673         foreach my $parameterIndex (@neededArguments) {
1674             next if exists $fetchedArguments{$parameterIndex};
1675             push(@implContent, "    JSValue arg$parameterIndex(state->argument($parameterIndex));\n");
1676             $fetchedArguments{$parameterIndex} = 1;
1677         }
1678
1679         my $conditionalString = $codeGenerator->GenerateConditionalString($overload->signature);
1680         push(@implContent, "#if ${conditionalString}\n") if $conditionalString;
1681
1682         push(@implContent, "    if ($parametersCheck)\n");
1683         push(@implContent, "        return ${functionName}$overload->{overloadIndex}(state);\n");
1684         push(@implContent, "#endif\n\n") if $conditionalString;
1685
1686     }
1687     if ($leastNumMandatoryParams >= 1) {
1688         push(@implContent, "    if (UNLIKELY(argsCount < $leastNumMandatoryParams))\n");
1689         push(@implContent, "        return throwVMError(state, createNotEnoughArgumentsError(state));\n");
1690     }
1691     push(@implContent, <<END);
1692     return throwVMTypeError(state);
1693 }
1694
1695 END
1696 }
1697
1698 sub GetNativeTypeForConversions
1699 {
1700     my $interface = shift;
1701     my $interfaceName = $interface->name;
1702     $interfaceName = $codeGenerator->GetSVGTypeNeedingTearOff($interfaceName) if $codeGenerator->IsSVGTypeNeedingTearOff($interfaceName);
1703     return $interfaceName;
1704 }
1705
1706 # See http://refspecs.linux-foundation.org/cxxabi-1.83.html.
1707 sub GetGnuVTableRefForInterface
1708 {
1709     my $interface = shift;
1710     my $vtableName = GetGnuVTableNameForInterface($interface);
1711     if (!$vtableName) {
1712         return "0";
1713     }
1714     my $typename = GetNativeTypeForConversions($interface);
1715     my $offset = GetGnuVTableOffsetForType($typename);
1716     return "&" . $vtableName . "[" . $offset . "]";
1717 }
1718
1719 sub GetGnuVTableNameForInterface
1720 {
1721     my $interface = shift;
1722     my $typename = GetNativeTypeForConversions($interface);
1723     my $templatePosition = index($typename, "<");
1724     return "" if $templatePosition != -1;
1725     return "" if GetImplementationLacksVTableForInterface($interface);
1726     return "" if GetSkipVTableValidationForInterface($interface);
1727     return "_ZTV" . GetGnuMangledNameForInterface($interface);
1728 }
1729
1730 sub GetGnuMangledNameForInterface
1731 {
1732     my $interface = shift;
1733     my $typename = GetNativeTypeForConversions($interface);
1734     my $templatePosition = index($typename, "<");
1735     if ($templatePosition != -1) {
1736         return "";
1737     }
1738     my $mangledType = length($typename) . $typename;
1739     my $namespace = GetNamespaceForInterface($interface);
1740     my $mangledNamespace =  "N" . length($namespace) . $namespace;
1741     return $mangledNamespace . $mangledType . "E";
1742 }
1743
1744 sub GetGnuVTableOffsetForType
1745 {
1746     my $typename = shift;
1747     if ($typename eq "SVGAElement"
1748         || $typename eq "SVGCircleElement"
1749         || $typename eq "SVGClipPathElement"
1750         || $typename eq "SVGDefsElement"
1751         || $typename eq "SVGEllipseElement"
1752         || $typename eq "SVGForeignObjectElement"
1753         || $typename eq "SVGGElement"
1754         || $typename eq "SVGImageElement"
1755         || $typename eq "SVGLineElement"
1756         || $typename eq "SVGPathElement"
1757         || $typename eq "SVGPolyElement"
1758         || $typename eq "SVGPolygonElement"
1759         || $typename eq "SVGPolylineElement"
1760         || $typename eq "SVGRectElement"
1761         || $typename eq "SVGSVGElement"
1762         || $typename eq "SVGGraphicsElement"
1763         || $typename eq "SVGSwitchElement"
1764         || $typename eq "SVGTextElement"
1765         || $typename eq "SVGUseElement") {
1766         return "3";
1767     }
1768     return "2";
1769 }
1770
1771 # See http://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B_Name_Mangling.
1772 sub GetWinVTableRefForInterface
1773 {
1774     my $interface = shift;
1775     my $vtableName = GetWinVTableNameForInterface($interface);
1776     return 0 if !$vtableName;
1777     return "__identifier(\"" . $vtableName . "\")";
1778 }
1779
1780 sub GetWinVTableNameForInterface
1781 {
1782     my $interface = shift;
1783     my $typename = GetNativeTypeForConversions($interface);
1784     my $templatePosition = index($typename, "<");
1785     return "" if $templatePosition != -1;
1786     return "" if GetImplementationLacksVTableForInterface($interface);
1787     return "" if GetSkipVTableValidationForInterface($interface);
1788     return "??_7" . GetWinMangledNameForInterface($interface) . "6B@";
1789 }
1790
1791 sub GetWinMangledNameForInterface
1792 {
1793     my $interface = shift;
1794     my $typename = GetNativeTypeForConversions($interface);
1795     my $namespace = GetNamespaceForInterface($interface);
1796     return $typename . "@" . $namespace . "@@";
1797 }
1798
1799 sub GetNamespaceForInterface
1800 {
1801     my $interface = shift;
1802     return $interface->extendedAttributes->{"ImplementationNamespace"} || "WebCore";
1803 }
1804
1805 sub GetImplementationLacksVTableForInterface
1806 {
1807     my $interface = shift;
1808     return $interface->extendedAttributes->{"ImplementationLacksVTable"};
1809 }
1810
1811 sub GetSkipVTableValidationForInterface
1812 {
1813     my $interface = shift;
1814     return $interface->extendedAttributes->{"SkipVTableValidation"};
1815 }
1816
1817 # URL becomes url, but SetURL becomes setURL.
1818 sub ToMethodName
1819 {
1820     my $param = shift;
1821     my $ret = lcfirst($param);
1822     $ret =~ s/hTML/html/ if $ret =~ /^hTML/;
1823     $ret =~ s/uRL/url/ if $ret =~ /^uRL/;
1824     $ret =~ s/jS/js/ if $ret =~ /^jS/;
1825     $ret =~ s/xML/xml/ if $ret =~ /^xML/;
1826     $ret =~ s/xSLT/xslt/ if $ret =~ /^xSLT/;
1827     $ret =~ s/cSS/css/ if $ret =~ /^cSS/;
1828
1829     # For HTML5 FileSystem API Flags attributes.
1830     # (create is widely used to instantiate an object and must be avoided.)
1831     $ret =~ s/^create/isCreate/ if $ret =~ /^create$/;
1832     $ret =~ s/^exclusive/isExclusive/ if $ret =~ /^exclusive$/;
1833
1834     return $ret;
1835 }
1836
1837 # Returns the RuntimeEnabledFeatures function name that is hooked up to check if a method/attribute is enabled.
1838 sub GetRuntimeEnableFunctionName
1839 {
1840     my $signature = shift;
1841
1842     # If a parameter is given (e.g. "EnabledAtRuntime=FeatureName") return the RuntimeEnabledFeatures::sharedFeatures().{FeatureName}Enabled() method.
1843     return "RuntimeEnabledFeatures::sharedFeatures()." . ToMethodName($signature->extendedAttributes->{"EnabledAtRuntime"}) . "Enabled" if ($signature->extendedAttributes->{"EnabledAtRuntime"} && $signature->extendedAttributes->{"EnabledAtRuntime"} ne "VALUE_IS_MISSING");
1844
1845     # Otherwise return a function named RuntimeEnabledFeatures::sharedFeatures().{methodName}Enabled().
1846     return "RuntimeEnabledFeatures::sharedFeatures()." . ToMethodName($signature->name) . "Enabled";
1847 }
1848
1849 sub GetCastingHelperForThisObject
1850 {
1851     my $interface = shift;
1852     my $interfaceName = $interface->name;
1853
1854     return "jsNodeCast" if $interfaceName eq "Node";
1855     return "jsElementCast" if $interfaceName eq "Element";
1856     return "jsDocumentCast" if $interfaceName eq "Document";
1857     return "jsEventTargetCast" if $interfaceName eq "EventTarget";
1858     return "jsDynamicCast<JS$interfaceName*>";
1859 }
1860
1861 sub GetIndexedGetterExpression
1862 {
1863     my $indexedGetterFunction = shift;
1864     if ($indexedGetterFunction->signature->type eq "DOMString") {
1865         return "jsStringOrUndefined(state, thisObject->wrapped().item(index))";
1866     }
1867     return "toJS(state, thisObject->globalObject(), thisObject->wrapped().item(index))";
1868 }
1869
1870 sub GenerateImplementation
1871 {
1872     my ($object, $interface, $enumerations) = @_;
1873
1874     my $interfaceName = $interface->name;
1875     my $className = "JS$interfaceName";
1876
1877     my $hasLegacyParent = $interface->extendedAttributes->{"JSLegacyParent"};
1878     my $hasRealParent = $interface->parent;
1879     my $hasParent = $hasLegacyParent || $hasRealParent;
1880     my $parentClassName = GetParentClassName($interface);
1881     my $visibleInterfaceName = $codeGenerator->GetVisibleInterfaceName($interface);
1882     my $eventTarget = $codeGenerator->InheritsInterface($interface, "EventTarget") && $interface->name ne "EventTarget";
1883     my $needsVisitChildren = InstanceNeedsVisitChildren($interface);
1884
1885     my $namedGetterFunction = GetNamedGetterFunction($interface);
1886     my $indexedGetterFunction = GetIndexedGetterFunction($interface);
1887
1888     # - Add default header template
1889     push(@implContentHeader, GenerateImplementationContentHeader($interface));
1890
1891     $implIncludes{"JSDOMBinding.h"} = 1;
1892     $implIncludes{"<wtf/GetPtr.h>"} = 1;
1893     $implIncludes{"<runtime/PropertyNameArray.h>"} = 1 if $indexedGetterFunction;
1894
1895     my $implType = GetImplClassName($interfaceName);
1896
1897     AddJSBuiltinIncludesIfNeeded($interface);
1898
1899     @implContent = ();
1900
1901     push(@implContent, "\nusing namespace JSC;\n\n");
1902     push(@implContent, "namespace WebCore {\n\n");
1903
1904     push(@implContent, GetEnumerationImplementationContent($enumerations));
1905
1906     my @functions = @{$interface->functions};
1907     push(@functions, @{$interface->iterable->functions}) if $interface->iterable;
1908
1909     my $numConstants = @{$interface->constants};
1910     my $numFunctions = @functions;
1911     my $numAttributes = @{$interface->attributes};
1912
1913     if ($numFunctions > 0) {
1914         my $inAppleCopyright = 0;
1915         push(@implContent,"// Functions\n\n");
1916         foreach my $function (@functions) {
1917             next if $function->{overloadIndex} && $function->{overloadIndex} > 1;
1918             next if $function->signature->extendedAttributes->{"ForwardDeclareInHeader"};
1919             next if IsJSBuiltin($interface, $function);
1920
1921             my $needsAppleCopyright = $function->signature->extendedAttributes->{"AppleCopyright"};
1922             if ($needsAppleCopyright) {
1923                 if (!$inAppleCopyright) {
1924                     push(@implContent, $beginAppleCopyrightForHeaderFiles);
1925                     $inAppleCopyright = 1;
1926                 }
1927             } elsif ($inAppleCopyright) {
1928                 push(@implContent, $endAppleCopyright);
1929                 $inAppleCopyright = 0;
1930             }
1931
1932             my $conditionalString = $codeGenerator->GenerateConditionalString($function->signature);
1933             push(@implContent, "#if ${conditionalString}\n") if $conditionalString;
1934             my $functionName = GetFunctionName($interface, $className, $function);
1935             push(@implContent, "JSC::EncodedJSValue JSC_HOST_CALL ${functionName}(JSC::ExecState*);\n");
1936             push(@implContent, "#endif\n") if $conditionalString;
1937         }
1938
1939         push(@implContent, $endAppleCopyright) if $inAppleCopyright;
1940
1941         push(@implContent, "\n");
1942     }
1943
1944     if ($numAttributes > 0 || NeedsConstructorProperty($interface)) {
1945         push(@implContent, "// Attributes\n\n");
1946         foreach my $attribute (@{$interface->attributes}) {
1947             next if $attribute->signature->extendedAttributes->{"ForwardDeclareInHeader"};
1948             next if IsJSBuiltin($interface, $attribute);
1949
1950             my $conditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
1951             push(@implContent, "#if ${conditionalString}\n") if $conditionalString;
1952             my $getter = GetAttributeGetterName($interfaceName, $className, $interface, $attribute);
1953             push(@implContent, "JSC::EncodedJSValue ${getter}(JSC::ExecState*, JSC::EncodedJSValue, JSC::PropertyName);\n");
1954             if (!IsReadonly($attribute)) {
1955                 my $setter = GetAttributeSetterName($interfaceName, $className, $interface, $attribute);
1956                 push(@implContent, "bool ${setter}(JSC::ExecState*, JSC::EncodedJSValue, JSC::EncodedJSValue);\n");
1957             }
1958             push(@implContent, "#endif\n") if $conditionalString;
1959         }
1960         
1961         if (NeedsConstructorProperty($interface)) {
1962             my $getter = "js" . $interfaceName . "Constructor";
1963             push(@implContent, "JSC::EncodedJSValue ${getter}(JSC::ExecState*, JSC::EncodedJSValue, JSC::PropertyName);\n");
1964         }
1965
1966         my $constructorFunctionName = "setJS" . $interfaceName . "Constructor";
1967         push(@implContent, "bool ${constructorFunctionName}(JSC::ExecState*, JSC::EncodedJSValue, JSC::EncodedJSValue);\n");
1968
1969         push(@implContent, "\n");
1970     }
1971
1972     # Add prototype declaration.
1973     if (!HeaderNeedsPrototypeDeclaration($interface)) {
1974         GeneratePrototypeDeclaration(\@implContent, $className, $interface, $interfaceName);
1975     }
1976
1977     # Add constructor declaration
1978     if (NeedsConstructorProperty($interface)) {
1979         GenerateConstructorDeclaration(\@implContent, $className, $interface, $interfaceName);
1980     }
1981
1982
1983     my @hashKeys = ();
1984     my @hashValue1 = ();
1985     my @hashValue2 = ();
1986     my @hashSpecials = ();
1987     my %conditionals = ();
1988     my $hashName = $className . "Table";
1989     my @runtimeEnabledFunctions = ();
1990     my @runtimeEnabledAttributes = ();
1991
1992     # Generate hash table for properties on the instance.
1993     my $numInstanceProperties = GeneratePropertiesHashTable($object, $interface, 1,
1994         \@hashKeys, \@hashSpecials,
1995         \@hashValue1, \@hashValue2,
1996         \%conditionals, \@runtimeEnabledFunctions, \@runtimeEnabledAttributes);
1997
1998     $object->GenerateHashTable($hashName, $numInstanceProperties,
1999         \@hashKeys, \@hashSpecials,
2000         \@hashValue1, \@hashValue2,
2001         \%conditionals, 0) if $numInstanceProperties > 0;
2002
2003     # - Add all interface object (aka constructor) properties (constants, static attributes, static operations).
2004     if (NeedsConstructorProperty($interface)) {
2005         my $hashSize = 0;
2006         my $hashName = $className . "ConstructorTable";
2007
2008         my @hashKeys = ();
2009         my @hashValue1 = ();
2010         my @hashValue2 = ();
2011         my @hashSpecials = ();
2012         my %conditionals = ();
2013
2014         my $needsConstructorTable = 0;
2015
2016         foreach my $constant (@{$interface->constants}) {
2017             my $name = $constant->name;
2018             push(@hashKeys, $name);
2019             push(@hashValue1, $constant->value);
2020             push(@hashValue2, "0");
2021             push(@hashSpecials, "DontDelete | ReadOnly | ConstantInteger");
2022
2023             my $implementedBy = $constant->extendedAttributes->{"ImplementedBy"};
2024             if ($implementedBy) {
2025                 $implIncludes{"${implementedBy}.h"} = 1;
2026             }
2027             my $conditional = $constant->extendedAttributes->{"Conditional"};
2028             if ($conditional) {
2029                 $conditionals{$name} = $conditional;
2030             }
2031             
2032             $hashSize++;
2033         }
2034
2035         foreach my $attribute (@{$interface->attributes}) {
2036             next unless ($attribute->isStatic);
2037             my $name = $attribute->signature->name;
2038             push(@hashKeys, $name);
2039
2040             my @specials = ();
2041             push(@specials, "DontDelete") unless $attribute->signature->extendedAttributes->{"Deletable"};
2042             push(@specials, "ReadOnly") if IsReadonly($attribute);
2043             my $special = (@specials > 0) ? join(" | ", @specials) : "0";
2044             push(@hashSpecials, $special);
2045
2046             my $getter = GetAttributeGetterName($interfaceName, $className, $interface, $attribute);
2047             push(@hashValue1, $getter);
2048
2049             if (IsReadonly($attribute)) {
2050                 push(@hashValue2, "0");
2051             } else {
2052                 my $setter = GetAttributeSetterName($interfaceName, $className, $interface, $attribute);
2053                 push(@hashValue2, $setter);
2054             }
2055
2056             my $conditional = $attribute->signature->extendedAttributes->{"Conditional"};
2057             if ($conditional) {
2058                 $conditionals{$name} = $conditional;
2059             }
2060
2061             $hashSize++;
2062         }
2063
2064         foreach my $function (@{$interface->functions}) {
2065             next unless ($function->isStatic);
2066             next if $function->{overloadIndex} && $function->{overloadIndex} > 1;
2067             my $name = $function->signature->name;
2068             push(@hashKeys, $name);
2069
2070             my $functionName = GetFunctionName($interface, $className, $function);
2071             push(@hashValue1, $functionName);
2072
2073             my $functionLength = GetFunctionLength($function);
2074             push(@hashValue2, $functionLength);
2075
2076             push(@hashSpecials, ComputeFunctionSpecial($interface, $function));
2077
2078             my $conditional = $function->signature->extendedAttributes->{"Conditional"};
2079             if ($conditional) {
2080                 $conditionals{$name} = $conditional;
2081             }
2082             
2083             $hashSize++;
2084         }
2085
2086         $object->GenerateHashTable($hashName, $hashSize,
2087                                    \@hashKeys, \@hashSpecials,
2088                                    \@hashValue1, \@hashValue2,
2089                                    \%conditionals, 1) if $hashSize > 0;
2090
2091         push(@implContent, $codeGenerator->GenerateCompileTimeCheckForEnumsIfNeeded($interface));
2092
2093         my $protoClassName = "${className}Prototype";
2094         GenerateConstructorDefinitions(\@implContent, $className, $protoClassName, $interfaceName, $visibleInterfaceName, $interface);
2095         if ($interface->extendedAttributes->{"NamedConstructor"}) {
2096             GenerateConstructorDefinitions(\@implContent, $className, $protoClassName, $interfaceName, $interface->extendedAttributes->{"NamedConstructor"}, $interface, "GeneratingNamedConstructor");
2097         }
2098     }
2099
2100     # - Add functions and constants to a hashtable definition
2101
2102     $hashName = $className . "PrototypeTable";
2103
2104     @hashKeys = ();
2105     @hashValue1 = ();
2106     @hashValue2 = ();
2107     @hashSpecials = ();
2108     %conditionals = ();
2109     @runtimeEnabledFunctions = ();
2110     @runtimeEnabledAttributes = ();
2111
2112     # Generate hash table for properties on the prototype.
2113     my $numPrototypeProperties = GeneratePropertiesHashTable($object, $interface, 0,
2114         \@hashKeys, \@hashSpecials,
2115         \@hashValue1, \@hashValue2,
2116         \%conditionals, \@runtimeEnabledFunctions, \@runtimeEnabledAttributes);
2117     my $hashSize = $numPrototypeProperties;
2118
2119     foreach my $constant (@{$interface->constants}) {
2120         my $name = $constant->name;
2121
2122         push(@hashKeys, $name);
2123         push(@hashValue1, $constant->value);
2124         push(@hashValue2, "0");
2125         push(@hashSpecials, "DontDelete | ReadOnly | ConstantInteger");
2126
2127         my $conditional = $constant->extendedAttributes->{"Conditional"};
2128         if ($conditional) {
2129             $conditionals{$name} = $conditional;
2130         }
2131         
2132         $hashSize++;
2133     }
2134
2135     my $justGenerateValueArray = !IsDOMGlobalObject($interface);
2136
2137     $object->GenerateHashTable($hashName, $hashSize,
2138                                \@hashKeys, \@hashSpecials,
2139                                \@hashValue1, \@hashValue2,
2140                                \%conditionals, $justGenerateValueArray);
2141
2142     if ($justGenerateValueArray) {
2143         push(@implContent, "const ClassInfo ${className}Prototype::s_info = { \"${visibleInterfaceName}Prototype\", &Base::s_info, 0, CREATE_METHOD_TABLE(${className}Prototype) };\n\n");
2144     } else {
2145         push(@implContent, "const ClassInfo ${className}Prototype::s_info = { \"${visibleInterfaceName}Prototype\", &Base::s_info, &${className}PrototypeTable, CREATE_METHOD_TABLE(${className}Prototype) };\n\n");
2146     }
2147
2148     if (PrototypeOverridesGetOwnPropertySlot($interface)) {
2149         my $prototypePropertyCount = PrototypePropertyCount($interface);
2150         my $prototypeFunctionCount = PrototypeFunctionCount($interface);
2151         my $prototypeAttributeCount = $prototypePropertyCount - $prototypeFunctionCount;
2152         if (IsDOMGlobalObject($interface)) {
2153             push(@implContent, "bool ${className}Prototype::getOwnPropertySlot(JSObject* object, ExecState* state, PropertyName propertyName, PropertySlot& slot)\n");
2154             push(@implContent, "{\n");
2155             push(@implContent, "    VM& vm = state->vm();\n");
2156             push(@implContent, "    UNUSED_PARAM(vm);\n");
2157             push(@implContent, "    auto* thisObject = jsCast<${className}Prototype*>(object);\n");
2158
2159             if ($numConstants eq 0 && $prototypePropertyCount eq 0) {
2160                 push(@implContent, "    return Base::getOwnPropertySlot(thisObject, state, propertyName, slot);\n");        
2161             } elsif ($numConstants eq 0 && $prototypeAttributeCount eq 0) {
2162                 push(@implContent, "    return getStaticFunctionSlot<JSObject>(state, ${className}PrototypeTable, thisObject, propertyName, slot);\n");
2163             } elsif ($prototypePropertyCount eq 0) {
2164                 push(@implContent, "    return getStaticValueSlot<${className}Prototype, JSObject>(state, ${className}PrototypeTable, thisObject, propertyName, slot);\n");
2165             } else {
2166                 push(@implContent, "    return getStaticPropertySlot<${className}Prototype, JSObject>(state, ${className}PrototypeTable, thisObject, propertyName, slot);\n");
2167             }
2168             push(@implContent, "}\n\n");
2169         } elsif ($numConstants > 0 || $numPrototypeProperties > 0) {
2170             push(@implContent, "void ${className}Prototype::finishCreation(VM& vm)\n");
2171             push(@implContent, "{\n");
2172             push(@implContent, "    Base::finishCreation(vm);\n");
2173             push(@implContent, "    reifyStaticProperties(vm, ${className}PrototypeTableValues, *this);\n");
2174
2175             my @runtimeEnabledProperties = @runtimeEnabledFunctions;
2176             push(@runtimeEnabledProperties, @runtimeEnabledAttributes);
2177             foreach my $functionOrAttribute (@runtimeEnabledProperties) {
2178                 my $signature = $functionOrAttribute->signature;
2179                 my $conditionalString = $codeGenerator->GenerateConditionalString($signature);
2180                 push(@implContent, "#if ${conditionalString}\n") if $conditionalString;
2181                 AddToImplIncludes("RuntimeEnabledFeatures.h");
2182                 my $enable_function = GetRuntimeEnableFunctionName($signature);
2183                 my $name = $signature->name;
2184                 push(@implContent, "    if (!${enable_function}()) {\n");
2185                 push(@implContent, "        Identifier propertyName = Identifier::fromString(&vm, reinterpret_cast<const LChar*>(\"$name\"), strlen(\"$name\"));\n");
2186                 push(@implContent, "        removeDirect(vm, propertyName);\n");
2187                 push(@implContent, "    }\n");
2188                 push(@implContent, "#endif\n") if $conditionalString;
2189             }
2190
2191             my $firstPrivateFunction = 1;
2192             foreach my $function (@{$interface->functions}) {
2193                 next unless ($function->signature->extendedAttributes->{"Private"});
2194                 AddToImplIncludes("WebCoreJSClientData.h");
2195                 push(@implContent, "    JSVMClientData& clientData = *static_cast<JSVMClientData*>(vm.clientData);\n") if $firstPrivateFunction;
2196                 $firstPrivateFunction = 0;
2197                 push(@implContent, "    putDirect(vm, clientData.builtinNames()." . $function->signature->name . "PrivateName(), JSFunction::create(vm, globalObject(), 0, String(), " . GetFunctionName($interface, $className, $function) . "), ReadOnly | DontEnum);\n");
2198             }
2199
2200             if ($interface->iterable) {
2201                 my $functionName = GetFunctionName($interface, $className, @{$interface->iterable->functions}[0]);
2202                 push(@implContent, "    putDirect(vm, vm.propertyNames->iteratorSymbol, JSFunction::create(vm, globalObject(), 0, ASCIILiteral(\"[Symbol.Iterator]\"), $functionName), ReadOnly | DontEnum);\n");
2203             }
2204
2205             push(@implContent, "}\n\n");
2206         } else {
2207             push(@implContent, "void ${className}Prototype::finishCreation(VM& vm)\n");
2208             push(@implContent, "{\n");
2209             push(@implContent, "    Base::finishCreation(vm);\n");
2210             push(@implContent, "}\n\n");
2211         }
2212     }
2213
2214     if ($interface->extendedAttributes->{"JSCustomNamedGetterOnPrototype"}) {
2215         push(@implContent, "bool ${className}Prototype::put(JSCell* cell, ExecState* state, PropertyName propertyName, JSValue value, PutPropertySlot& slot)\n");
2216         push(@implContent, "{\n");
2217         push(@implContent, "    auto* thisObject = jsCast<${className}Prototype*>(cell);\n");
2218         push(@implContent, "    bool putResult = false;\n");
2219         push(@implContent, "    if (thisObject->putDelegate(state, propertyName, value, slot, putResult))\n");
2220         push(@implContent, "        return putResult;\n");
2221         push(@implContent, "    return Base::put(thisObject, state, propertyName, value, slot);\n");
2222         push(@implContent, "}\n\n");
2223     }
2224
2225     # - Initialize static ClassInfo object
2226     push(@implContent, "const ClassInfo $className" . "::s_info = { \"${visibleInterfaceName}\", &Base::s_info, ");
2227
2228     if ($numInstanceProperties > 0) {
2229         push(@implContent, "&${className}Table");
2230     } else {
2231         push(@implContent, "0");
2232     }
2233     push(@implContent, ", CREATE_METHOD_TABLE($className) };\n\n");
2234
2235     my ($svgPropertyType, $svgListPropertyType, $svgNativeType) = GetSVGPropertyTypes($interfaceName);
2236     my $svgPropertyOrListPropertyType;
2237     $svgPropertyOrListPropertyType = $svgPropertyType if $svgPropertyType;
2238     $svgPropertyOrListPropertyType = $svgListPropertyType if $svgListPropertyType;
2239
2240     # Constructor
2241     if ($interfaceName eq "DOMWindow") {
2242         AddIncludesForTypeInImpl("JSDOMWindowShell");
2243         push(@implContent, "${className}::$className(VM& vm, Structure* structure, Ref<$implType>&& impl, JSDOMWindowShell* shell)\n");
2244         push(@implContent, "    : $parentClassName(vm, structure, WTFMove(impl), shell)\n");
2245         push(@implContent, "{\n");
2246         push(@implContent, "}\n\n");
2247     } elsif ($codeGenerator->InheritsInterface($interface, "WorkerGlobalScope")) {
2248         AddIncludesForTypeInImpl($interfaceName);
2249         push(@implContent, "${className}::$className(VM& vm, Structure* structure, Ref<$implType>&& impl)\n");
2250         push(@implContent, "    : $parentClassName(vm, structure, WTFMove(impl))\n");
2251         push(@implContent, "{\n");
2252         push(@implContent, "}\n\n");
2253     } elsif (!NeedsImplementationClass($interface)) {
2254         push(@implContent, "${className}::$className(Structure* structure, JSDOMGlobalObject& globalObject)\n");
2255         push(@implContent, "    : $parentClassName(structure, globalObject) { }\n\n");
2256     } else {
2257         push(@implContent, "${className}::$className(Structure* structure, JSDOMGlobalObject& globalObject, Ref<$implType>&& impl)\n");
2258         push(@implContent, "    : $parentClassName(structure, globalObject, WTFMove(impl))\n");
2259         push(@implContent, "{\n");
2260         push(@implContent, "}\n\n");
2261     }
2262
2263     if (IsDOMGlobalObject($interface)) {
2264         if ($interfaceName eq "DOMWindow") {
2265             push(@implContent, "void ${className}::finishCreation(VM& vm, JSDOMWindowShell* shell)\n");
2266             push(@implContent, "{\n");
2267             push(@implContent, "    Base::finishCreation(vm, shell);\n\n");
2268         } else {
2269             push(@implContent, "void ${className}::finishCreation(VM& vm)\n");
2270             push(@implContent, "{\n");
2271             push(@implContent, "    Base::finishCreation(vm);\n\n");
2272         }
2273         # Support for RuntimeEnabled attributes on global objects.
2274         foreach my $attribute (@{$interface->attributes}) {
2275             next unless $attribute->signature->extendedAttributes->{"EnabledAtRuntime"};
2276
2277             AddToImplIncludes("RuntimeEnabledFeatures.h");
2278             my $conditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
2279             push(@implContent, "#if ${conditionalString}\n") if $conditionalString;
2280             my $enable_function = GetRuntimeEnableFunctionName($attribute->signature);
2281             my $attributeName = $attribute->signature->name;
2282             push(@implContent, "    if (${enable_function}()) {\n");
2283             my $getter = GetAttributeGetterName($interfaceName, $className, $interface, $attribute);
2284             my $setter = IsReadonly($attribute) ? "nullptr" : GetAttributeSetterName($interfaceName, $className, $interface, $attribute);
2285             push(@implContent, "        auto* customGetterSetter = CustomGetterSetter::create(vm, $getter, $setter);\n");
2286             my $jscAttributes = GetJSCAttributesForAttribute($interface, $attribute);
2287             push(@implContent, "        putDirectCustomAccessor(vm, vm.propertyNames->$attributeName, customGetterSetter, attributesForStructure($jscAttributes));\n");
2288             push(@implContent, "    }\n");
2289             push(@implContent, "#endif\n") if $conditionalString;
2290         }
2291         # Support for RuntimeEnabled operations on global objects.
2292         foreach my $function (@{$interface->functions}) {
2293             next unless $function->signature->extendedAttributes->{"EnabledAtRuntime"};
2294             next if $function->{overloadIndex} && $function->{overloadIndex} > 1;
2295
2296             AddToImplIncludes("RuntimeEnabledFeatures.h");
2297             my $conditionalString = $codeGenerator->GenerateConditionalString($function->signature);
2298             push(@implContent, "#if ${conditionalString}\n") if $conditionalString;
2299             my $enable_function = GetRuntimeEnableFunctionName($function->signature);
2300             my $functionName = $function->signature->name;
2301             my $implementationFunction = GetFunctionName($interface, $className, $function);
2302             my $functionLength = GetFunctionLength($function);
2303             my $jsAttributes = ComputeFunctionSpecial($interface, $function);
2304             push(@implContent, "    if (${enable_function}())\n");
2305             push(@implContent, "        putDirectNativeFunction(vm, this, vm.propertyNames->$functionName, $functionLength, $implementationFunction, NoIntrinsic, attributesForStructure($jsAttributes));\n");
2306             push(@implContent, "#endif\n") if $conditionalString;
2307         }
2308         push(@implContent, "}\n\n");
2309     } else {
2310         push(@implContent, "JSObject* ${className}::createPrototype(VM& vm, JSGlobalObject* globalObject)\n");
2311         push(@implContent, "{\n");
2312         if ($hasParent && $parentClassName ne "JSC::DOMNodeFilter") {
2313             push(@implContent, "    return ${className}Prototype::create(vm, globalObject, ${className}Prototype::createStructure(vm, globalObject, ${parentClassName}::prototype(vm, globalObject)));\n");
2314         } else {
2315             my $prototype = $interface->isException ? "errorPrototype" : "objectPrototype";
2316             push(@implContent, "    return ${className}Prototype::create(vm, globalObject, ${className}Prototype::createStructure(vm, globalObject, globalObject->${prototype}()));\n");
2317         }
2318         push(@implContent, "}\n\n");
2319
2320         push(@implContent, "JSObject* ${className}::prototype(VM& vm, JSGlobalObject* globalObject)\n");
2321         push(@implContent, "{\n");
2322         push(@implContent, "    return getDOMPrototype<${className}>(vm, globalObject);\n");
2323         push(@implContent, "}\n\n");
2324     }
2325
2326     if (!$hasParent) {
2327         push(@implContent, "void ${className}::destroy(JSC::JSCell* cell)\n");
2328         push(@implContent, "{\n");
2329         push(@implContent, "    ${className}* thisObject = static_cast<${className}*>(cell);\n");
2330         push(@implContent, "    thisObject->${className}::~${className}();\n");
2331         push(@implContent, "}\n\n");
2332     }
2333
2334     my $hasGetter = InstanceOverridesGetOwnPropertySlot($interface);
2335
2336     # Attributes
2337     if ($hasGetter) {
2338         if (!$interface->extendedAttributes->{"CustomGetOwnPropertySlot"}) {
2339             push(@implContent, "bool ${className}::getOwnPropertySlot(JSObject* object, ExecState* state, PropertyName propertyName, PropertySlot& slot)\n");
2340             push(@implContent, "{\n");
2341             push(@implContent, "    auto* thisObject = jsCast<${className}*>(object);\n");
2342             push(@implContent, "    ASSERT_GC_OBJECT_INHERITS(thisObject, info());\n");
2343             push(@implContent, GenerateGetOwnPropertySlotBody($interface, $interfaceName, $className, $numInstanceProperties > 0, 0));
2344             push(@implContent, "}\n\n");
2345         }
2346
2347         if ($indexedGetterFunction || $namedGetterFunction
2348                 || $interface->extendedAttributes->{"CustomNamedGetter"}
2349                 || $interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"}) {
2350             push(@implContent, "bool ${className}::getOwnPropertySlotByIndex(JSObject* object, ExecState* state, unsigned index, PropertySlot& slot)\n");
2351             push(@implContent, "{\n");
2352             push(@implContent, "    auto* thisObject = jsCast<${className}*>(object);\n");
2353             push(@implContent, "    ASSERT_GC_OBJECT_INHERITS(thisObject, info());\n");
2354
2355             # Sink the int-to-string conversion that happens when we create a PropertyName
2356             # to the point where we actually need it.
2357             my $generatedPropertyName = 0;
2358             my $propertyNameGeneration = sub {
2359                 if ($generatedPropertyName) {
2360                     return;
2361                 }
2362                 push(@implContent, "    Identifier propertyName = Identifier::from(state, index);\n");
2363                 $generatedPropertyName = 1;
2364             };
2365
2366             if ($indexedGetterFunction) {
2367                 if ($indexedGetterFunction->signature->type eq "DOMString") {
2368                     push(@implContent, "    if (LIKELY(index <= MAX_ARRAY_INDEX)) {\n");
2369                 } else {
2370                     push(@implContent, "    if (LIKELY(index < thisObject->wrapped().length())) {\n");
2371                 }
2372                 # Assume that if there's a setter, the index will be writable
2373                 if ($interface->extendedAttributes->{"CustomIndexedSetter"}) {
2374                     push(@implContent, "        unsigned attributes = DontDelete;\n");
2375                 } else {
2376                     push(@implContent, "        unsigned attributes = DontDelete | ReadOnly;\n");
2377                 }
2378                 push(@implContent, "        slot.setValue(thisObject, attributes, " . GetIndexedGetterExpression($indexedGetterFunction) . ");\n");
2379                 push(@implContent, "        return true;\n");
2380                 push(@implContent, "    }\n");
2381             }
2382
2383             # Indexing an object with an integer that is not a supported property index should not call the named property getter.
2384             # https://heycam.github.io/webidl/#idl-indexed-properties
2385             if (!$indexedGetterFunction && ($namedGetterFunction || $interface->extendedAttributes->{"CustomNamedGetter"})) {
2386                 &$propertyNameGeneration();
2387
2388                 # This condition is to make sure we use the subclass' named getter instead of the base class one when possible.
2389                 push(@implContent, "    if (thisObject->classInfo() == info()) {\n");
2390                 push(@implContent, "        JSValue value;\n");
2391                 push(@implContent, "        if (thisObject->nameGetter(state, propertyName, value)) {\n");
2392                 push(@implContent, "            slot.setValue(thisObject, ReadOnly | DontDelete | DontEnum, value);\n");
2393                 push(@implContent, "            return true;\n");
2394                 push(@implContent, "        }\n");
2395                 push(@implContent, "    }\n");
2396                 $implIncludes{"wtf/text/AtomicString.h"} = 1;
2397             }
2398
2399             if ($interface->extendedAttributes->{"JSCustomGetOwnPropertySlotAndDescriptor"}) {
2400                 &$propertyNameGeneration();
2401                 push(@implContent, "    if (thisObject->getOwnPropertySlotDelegate(state, propertyName, slot))\n");
2402                 push(@implContent, "        return true;\n");
2403             }
2404
2405             push(@implContent, "    return Base::getOwnPropertySlotByIndex(thisObject, state, index, slot);\n");
2406             push(@implContent, "}\n\n");
2407         }
2408
2409     }
2410     $numAttributes = $numAttributes + 1 if NeedsConstructorProperty($interface);
2411     if ($numAttributes > 0) {
2412         foreach my $attribute (@{$interface->attributes}) {
2413             next if IsJSBuiltin($interface, $attribute);
2414
2415             my $name = $attribute->signature->name;
2416             my $type = $attribute->signature->type;
2417             $codeGenerator->AssertNotSequenceType($type);
2418             my $getFunctionName = GetAttributeGetterName($interfaceName, $className, $interface, $attribute);
2419             my $implGetterFunctionName = $codeGenerator->WK_lcfirst($attribute->signature->extendedAttributes->{"ImplementedAs"} || $name);
2420             my $getterExceptionsWithMessage = $attribute->signature->extendedAttributes->{"GetterRaisesExceptionWithMessage"};
2421             my $getterExceptions = $attribute->signature->extendedAttributes->{"GetterRaisesException"} || $getterExceptionsWithMessage;
2422
2423             if ($getterExceptions) {
2424                 $implIncludes{"ExceptionCode.h"} = 1;
2425             }
2426
2427             my $attributeConditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
2428             push(@implContent, "#if ${attributeConditionalString}\n") if $attributeConditionalString;
2429
2430             push(@implContent, "EncodedJSValue ${getFunctionName}(ExecState* state, EncodedJSValue thisValue, PropertyName)\n");
2431             push(@implContent, "{\n");
2432
2433             push(@implContent, "    UNUSED_PARAM(state);\n");
2434             push(@implContent, "    UNUSED_PARAM(thisValue);\n");
2435
2436             if (!$attribute->isStatic || $attribute->signature->type =~ /Constructor$/) {
2437                 push(@implContent, "    JSValue decodedThisValue = JSValue::decode(thisValue);\n");
2438                 my $castingFunction = $interface->extendedAttributes->{"CustomProxyToJSObject"} ? "to${className}" : GetCastingHelperForThisObject($interface);
2439                 # http://heycam.github.io/webidl/#ImplicitThis
2440                 if ($interface->extendedAttributes->{"ImplicitThis"}) {
2441                     push(@implContent, "    auto* castedThis = decodedThisValue.isUndefinedOrNull() ? $castingFunction(state->thisValue().toThis(state, NotStrictMode)) : $castingFunction(decodedThisValue);\n");
2442                 } else {
2443                     push(@implContent, "    auto* castedThis = $castingFunction(decodedThisValue);\n");
2444                 }
2445                 push(@implContent, "    if (UNLIKELY(!castedThis)) {\n");
2446                 if ($attribute->signature->extendedAttributes->{"LenientThis"}) {
2447                     push(@implContent, "        return JSValue::encode(jsUndefined());\n");
2448                 } elsif (InterfaceRequiresAttributesOnInstanceForCompatibility($interface)) {
2449                     # Fallback to trying to searching the prototype chain for compatibility reasons.
2450                     push(@implContent, "        JSObject* thisObject = JSValue::decode(thisValue).getObject();\n");
2451                     push(@implContent, "        for (thisObject = thisObject ? thisObject->getPrototypeDirect().getObject() : nullptr; thisObject; thisObject = thisObject->getPrototypeDirect().getObject()) {\n");
2452                     push(@implContent, "            if ((castedThis = " . GetCastingHelperForThisObject($interface) . "(thisObject)))\n");
2453                     push(@implContent, "                break;\n");
2454                     push(@implContent, "        }\n");
2455                     push(@implContent, "        if (!castedThis)\n");
2456                     push(@implContent, "            return throwGetterTypeError(*state, \"$interfaceName\", \"$name\");\n");
2457                     push(@implContent, "        reportDeprecatedGetterError(*state, \"$interfaceName\", \"$name\");\n");
2458                 } else {
2459                     push(@implContent, "        return throwGetterTypeError(*state, \"$interfaceName\", \"$name\");\n");
2460                 }
2461                 push(@implContent, "    }\n");
2462             }
2463
2464             my @arguments = ();
2465             if ($getterExceptions && !HasCustomGetter($attribute->signature->extendedAttributes)) {
2466                 push(@arguments, "ec");
2467                 if ($getterExceptionsWithMessage) {
2468                     push(@implContent, "    ExceptionCodeWithMessage ec;\n");
2469                 } else {
2470                     push(@implContent, "    ExceptionCode ec = 0;\n");
2471                 }
2472             }
2473
2474             # Global constructors can be disabled at runtime.
2475             if ($attribute->signature->type =~ /Constructor$/) {
2476                 if ($attribute->signature->extendedAttributes->{"EnabledBySetting"}) {
2477                     AddToImplIncludes("Frame.h");
2478                     AddToImplIncludes("Settings.h");
2479                     my $enable_function = ToMethodName($attribute->signature->extendedAttributes->{"EnabledBySetting"}) . "Enabled";
2480                     push(@implContent, "    if (UNLIKELY(!castedThis->wrapped().frame()))\n");
2481                     push(@implContent, "        return JSValue::encode(jsUndefined());\n");
2482                     push(@implContent, "    Settings& settings = castedThis->wrapped().frame()->settings();\n");
2483                     push(@implContent, "    if (!settings.$enable_function())\n");
2484                     push(@implContent, "        return JSValue::encode(jsUndefined());\n");
2485                 }
2486             }
2487
2488             if ($attribute->signature->extendedAttributes->{"CachedAttribute"}) {
2489                 $needsVisitChildren = 1;
2490             }
2491
2492             if ($interface->extendedAttributes->{"CheckSecurity"} &&
2493                 !$attribute->signature->extendedAttributes->{"DoNotCheckSecurity"} &&
2494                 !$attribute->signature->extendedAttributes->{"DoNotCheckSecurityOnGetter"}) {
2495                 push(@implContent, "    if (!BindingSecurity::shouldAllowAccessToDOMWindow(state, castedThis->wrapped()))\n");
2496                 push(@implContent, "        return JSValue::encode(jsUndefined());\n");
2497             }
2498
2499             if ($attribute->signature->extendedAttributes->{"Nondeterministic"}) {
2500                 AddToImplIncludes("MemoizedDOMResult.h", "WEB_REPLAY");
2501                 AddToImplIncludes("<replay/InputCursor.h>", "WEB_REPLAY");
2502                 AddToImplIncludes("<wtf/NeverDestroyed.h>", "WEB_REPLAY");
2503
2504                 push(@implContent, "#if ENABLE(WEB_REPLAY)\n");
2505                 push(@implContent, "    JSGlobalObject* globalObject = state->lexicalGlobalObject();\n");
2506                 push(@implContent, "    InputCursor& cursor = globalObject->inputCursor();\n");
2507
2508                 my $nativeType = GetNativeType($type);
2509                 my $memoizedType = GetNativeTypeForMemoization($type);
2510                 my $exceptionCode = $getterExceptionsWithMessage ? "ec.code" : ($getterExceptions ? "ec" : "0");
2511                 push(@implContent, "    static NeverDestroyed<const AtomicString> bindingName(\"$interfaceName.$name\", AtomicString::ConstructFromLiteral);\n");
2512                 push(@implContent, "    if (cursor.isCapturing()) {\n");
2513                 push(@implContent, "        $memoizedType memoizedResult = castedThis->wrapped().$implGetterFunctionName(" . join(", ", @arguments) . ");\n");
2514                 push(@implContent, "        cursor.appendInput<MemoizedDOMResult<$memoizedType>>(bindingName.get().string(), memoizedResult, $exceptionCode);\n");
2515                 push(@implContent, "        JSValue result = " . NativeToJSValue($attribute->signature, 0, $interfaceName, "memoizedResult", "castedThis") . ";\n");
2516                 push(@implContent, "        setDOMException(state, ec);\n") if $getterExceptions;
2517                 push(@implContent, "        return JSValue::encode(result);\n");
2518                 push(@implContent, "    }\n");
2519                 push(@implContent, "\n");
2520                 push(@implContent, "    if (cursor.isReplaying()) {\n");
2521                 push(@implContent, "        $memoizedType memoizedResult;\n");
2522                 push(@implContent, "        MemoizedDOMResultBase* input = cursor.fetchInput<MemoizedDOMResultBase>();\n");
2523                 push(@implContent, "        if (input && input->convertTo<$memoizedType>(memoizedResult)) {\n");
2524                 # FIXME: the generated code should report an error if an input cannot be fetched or converted.
2525                 push(@implContent, "            JSValue result = " . NativeToJSValue($attribute->signature, 0, $interfaceName, "memoizedResult", "castedThis") . ";\n");
2526                 push(@implContent, "            setDOMException(state, input->exceptionCode());\n") if $getterExceptions;
2527                 push(@implContent, "            return JSValue::encode(result);\n");
2528                 push(@implContent, "        }\n");
2529                 push(@implContent, "    }\n");
2530                 push(@implContent, "#endif\n");
2531             } # attribute Nondeterministic
2532
2533             if (HasCustomGetter($attribute->signature->extendedAttributes)) {
2534                 push(@implContent, "    return JSValue::encode(castedThis->$implGetterFunctionName(*state));\n");
2535             } elsif ($attribute->signature->extendedAttributes->{"CheckSecurityForNode"}) {
2536                 $implIncludes{"JSDOMBinding.h"} = 1;
2537                 push(@implContent, "    auto& impl = castedThis->wrapped();\n");
2538                 push(@implContent, "    return JSValue::encode(shouldAllowAccessToNode(state, impl." . $attribute->signature->name . "()) ? " . NativeToJSValue($attribute->signature, 0, $interfaceName, "impl.$implGetterFunctionName()", "castedThis") . " : jsNull());\n");
2539             } elsif ($type eq "EventHandler") {
2540                 my $getter = $attribute->signature->extendedAttributes->{"WindowEventHandler"} ? "windowEventHandlerAttribute"
2541                     : $attribute->signature->extendedAttributes->{"DocumentEventHandler"} ? "documentEventHandlerAttribute"
2542                     : "eventHandlerAttribute";
2543                 my $eventName = EventHandlerAttributeEventName($attribute);
2544                 push(@implContent, "    UNUSED_PARAM(state);\n");
2545                 push(@implContent, "    return JSValue::encode($getter(castedThis->wrapped(), $eventName));\n");
2546             } elsif ($attribute->signature->type =~ /Constructor$/) {
2547                 my $constructorType = $attribute->signature->type;
2548                 $constructorType =~ s/Constructor$//;
2549                 # When Constructor attribute is used by DOMWindow.idl, it's correct to pass castedThis as the global object
2550                 # When JSDOMWrappers have a back-pointer to the globalObject we can pass castedThis->globalObject()
2551                 if ($interfaceName eq "DOMWindow") {
2552                     my $named = ($constructorType =~ /Named$/) ? "Named" : "";
2553                     $constructorType =~ s/Named$//;
2554                     push(@implContent, "    return JSValue::encode(JS" . $constructorType . "::get${named}Constructor(state->vm(), castedThis));\n");
2555                 } else {
2556                     AddToImplIncludes("JS" . $constructorType . ".h", $attribute->signature->extendedAttributes->{"Conditional"});
2557                     push(@implContent, "    return JSValue::encode(JS" . $constructorType . "::getConstructor(state->vm(), castedThis->globalObject()));\n");
2558                 }
2559             } elsif (!$attribute->signature->extendedAttributes->{"GetterRaisesException"} && !$attribute->signature->extendedAttributes->{"GetterRaisesExceptionWithMessage"}) {
2560                 my $cacheIndex = 0;
2561                 if ($attribute->signature->extendedAttributes->{"CachedAttribute"}) {
2562                     $cacheIndex = $currentCachedAttribute;
2563                     $currentCachedAttribute++;
2564                     push(@implContent, "    if (JSValue cachedValue = castedThis->m_" . $attribute->signature->name . ".get())\n");
2565                     push(@implContent, "        return JSValue::encode(cachedValue);\n");
2566                 }
2567
2568                 my @callWithArgs = GenerateCallWith($attribute->signature->extendedAttributes->{"CallWith"}, \@implContent, "JSValue::encode(jsUndefined())");
2569
2570                 if ($svgListPropertyType) {
2571                     push(@implContent, "    JSValue result =  " . NativeToJSValue($attribute->signature, 0, $interfaceName, "castedThis->wrapped().$implGetterFunctionName(" . (join ", ", @callWithArgs) . ")", "castedThis") . ";\n");
2572                 } elsif ($svgPropertyOrListPropertyType) {
2573                     push(@implContent, "    $svgPropertyOrListPropertyType& impl = castedThis->wrapped().propertyReference();\n");
2574                     if ($svgPropertyOrListPropertyType eq "float") { # Special case for JSSVGNumber
2575                         push(@implContent, "    JSValue result = " . NativeToJSValue($attribute->signature, 0, $interfaceName, "impl", "castedThis") . ";\n");
2576                     } else {
2577                         push(@implContent, "    JSValue result = " . NativeToJSValue($attribute->signature, 0, $interfaceName, "impl.$implGetterFunctionName(" . (join ", ", @callWithArgs) . ")", "castedThis") . ";\n");
2578
2579                     }
2580                 } else {
2581                     my ($functionName, @arguments) = $codeGenerator->GetterExpression(\%implIncludes, $interfaceName, $attribute);
2582                     if ($attribute->signature->extendedAttributes->{"ImplementedBy"}) {
2583                         my $implementedBy = $attribute->signature->extendedAttributes->{"ImplementedBy"};
2584                         $implIncludes{"${implementedBy}.h"} = 1;
2585                         $functionName = "WebCore::${implementedBy}::${functionName}";
2586                         unshift(@arguments, "impl") if !$attribute->isStatic;
2587                     } elsif ($attribute->isStatic) {
2588                         $functionName = "${interfaceName}::${functionName}";
2589                     } else {
2590                         $functionName = "impl.${functionName}";
2591                     }
2592
2593                     unshift(@arguments, @callWithArgs);
2594                     my $jsType = NativeToJSValue($attribute->signature, 0, $interfaceName, "${functionName}(" . join(", ", @arguments) . ")", "castedThis");
2595                     push(@implContent, "    auto& impl = castedThis->wrapped();\n") if !$attribute->isStatic;
2596                     if ($codeGenerator->IsSVGAnimatedType($type)) {
2597                         push(@implContent, "    RefPtr<$type> obj = $jsType;\n");
2598                         push(@implContent, "    JSValue result = toJS(state, castedThis->globalObject(), obj.get());\n");
2599                     } else {
2600                         push(@implContent, "    JSValue result = $jsType;\n");
2601                     }
2602                 }
2603
2604                 push(@implContent, "    castedThis->m_" . $attribute->signature->name . ".set(state->vm(), castedThis, result);\n") if ($attribute->signature->extendedAttributes->{"CachedAttribute"});
2605                 push(@implContent, "    return JSValue::encode(result);\n");
2606
2607             } else {
2608                 unshift(@arguments, GenerateCallWith($attribute->signature->extendedAttributes->{"CallWith"}, \@implContent, "JSValue::encode(jsUndefined())"));
2609
2610                 if ($svgPropertyOrListPropertyType) {
2611                     push(@implContent, "    $svgPropertyOrListPropertyType impl(*castedThis->wrapped());\n");
2612                     push(@implContent, "    JSValue result = " . NativeToJSValue($attribute->signature, 0, $interfaceName, "impl.$implGetterFunctionName(" . join(", ", @arguments) . ")", "castedThis") . ";\n");
2613                 } else {
2614                     push(@implContent, "    auto& impl = castedThis->wrapped();\n");
2615                     push(@implContent, "    JSValue result = " . NativeToJSValue($attribute->signature, 0, $interfaceName, "impl.$implGetterFunctionName(" . join(", ", @arguments) . ")", "castedThis") . ";\n");
2616                 }
2617
2618                 push(@implContent, "    setDOMException(state, ec);\n");
2619
2620                 push(@implContent, "    return JSValue::encode(result);\n");
2621             }
2622
2623             push(@implContent, "}\n\n");
2624
2625             push(@implContent, "#endif\n") if $attributeConditionalString;
2626
2627             push(@implContent, "\n");
2628         }
2629
2630         if (NeedsConstructorProperty($interface)) {
2631             my $constructorFunctionName = "js" . $interfaceName . "Constructor";
2632
2633             push(@implContent, "EncodedJSValue ${constructorFunctionName}(ExecState* state, EncodedJSValue thisValue, PropertyName)\n");
2634             push(@implContent, "{\n");
2635             push(@implContent, "    ${className}Prototype* domObject = jsDynamicCast<${className}Prototype*>(JSValue::decode(thisValue));\n");
2636             push(@implContent, "    if (UNLIKELY(!domObject))\n");
2637             push(@implContent, "        return throwVMTypeError(state);\n");
2638
2639             if (!$interface->extendedAttributes->{"NoInterfaceObject"}) {
2640                 push(@implContent, "    return JSValue::encode(${className}::getConstructor(state->vm(), domObject->globalObject()));\n");
2641             } else {
2642                 push(@implContent, "    JSValue constructor = ${className}Constructor::create(state->vm(), ${className}Constructor::createStructure(state->vm(), *domObject->globalObject(), domObject->globalObject()->objectPrototype()), *jsCast<JSDOMGlobalObject*>(domObject->globalObject()));\n");
2643                 push(@implContent, "    // Shadowing constructor property to ensure reusing the same constructor object\n");
2644                 push(@implContent, "    domObject->putDirect(state->vm(), state->propertyNames().constructor, constructor, DontEnum | ReadOnly);\n");
2645                 push(@implContent, "    return JSValue::encode(constructor);\n");
2646             }
2647             push(@implContent, "}\n\n");
2648         }
2649
2650         my $constructorFunctionName = "setJS" . $interfaceName . "Constructor";
2651
2652         push(@implContent, "bool ${constructorFunctionName}(ExecState* state, EncodedJSValue thisValue, EncodedJSValue encodedValue)\n");
2653         push(@implContent, "{\n");
2654         push(@implContent, "    JSValue value = JSValue::decode(encodedValue);\n");
2655         push(@implContent, "    ${className}Prototype* domObject = jsDynamicCast<${className}Prototype*>(JSValue::decode(thisValue));\n");
2656         push(@implContent, "    if (UNLIKELY(!domObject)) {\n");
2657         push(@implContent, "        throwVMTypeError(state);\n");
2658         push(@implContent, "        return false;\n");
2659         push(@implContent, "    }\n");
2660
2661         push(@implContent, "    // Shadowing a built-in constructor\n");
2662
2663         push(@implContent, "    return domObject->putDirect(state->vm(), state->propertyNames().constructor, value);\n");
2664         push(@implContent, "}\n\n");
2665     }
2666     my $hasCustomSetter = $interface->extendedAttributes->{"CustomNamedSetter"}
2667                           || $interface->extendedAttributes->{"CustomIndexedSetter"};
2668
2669     if ($hasCustomSetter) {
2670         if (!$interface->extendedAttributes->{"CustomPutFunction"}) {
2671             push(@implContent, "bool ${className}::put(JSCell* cell, ExecState* state, PropertyName propertyName, JSValue value, PutPropertySlot& slot)\n");
2672             push(@implContent, "{\n");
2673             push(@implContent, "    auto* thisObject = jsCast<${className}*>(cell);\n");
2674             push(@implContent, "    ASSERT_GC_OBJECT_INHERITS(thisObject, info());\n");
2675             if ($interface->extendedAttributes->{"CustomIndexedSetter"}) {
2676                 push(@implContent, "    if (Optional<uint32_t> index = parseIndex(propertyName)) {\n");
2677                 push(@implContent, "        thisObject->indexSetter(state, index.value(), value);\n");
2678                 push(@implContent, "        return true;\n");
2679                 push(@implContent, "    }\n");
2680             }
2681             if ($interface->extendedAttributes->{"CustomNamedSetter"}) {
2682                 push(@implContent, "    bool putResult = false;\n");
2683                 push(@implContent, "    if (thisObject->putDelegate(state, propertyName, value, slot, putResult))\n");
2684                 push(@implContent, "        return putResult;\n");
2685             }
2686
2687             push(@implContent, "    return Base::put(thisObject, state, propertyName, value, slot);\n");
2688             push(@implContent, "}\n\n");
2689
2690             if ($interface->extendedAttributes->{"CustomIndexedSetter"} || $interface->extendedAttributes->{"CustomNamedSetter"}) {
2691                 push(@implContent, "bool ${className}::putByIndex(JSCell* cell, ExecState* state, unsigned index, JSValue value, bool shouldThrow)\n");
2692                 push(@implContent, "{\n");
2693                 push(@implContent, "    auto* thisObject = jsCast<${className}*>(cell);\n");
2694                 push(@implContent, "    ASSERT_GC_OBJECT_INHERITS(thisObject, info());\n");
2695
2696                 if ($interface->extendedAttributes->{"CustomIndexedSetter"}) {
2697                     push(@implContent, "    if (LIKELY(index <= MAX_ARRAY_INDEX)) {\n");
2698                     push(@implContent, "        thisObject->indexSetter(state, index, value);\n");
2699                     push(@implContent, "        return true;\n");
2700                     push(@implContent, "    }\n");
2701                 }
2702
2703                 if ($interface->extendedAttributes->{"CustomNamedSetter"}) {
2704                     push(@implContent, "    Identifier propertyName = Identifier::from(state, index);\n");
2705                     push(@implContent, "    PutPropertySlot slot(thisObject, shouldThrow);\n");
2706                     push(@implContent, "    bool putResult = false;\n");
2707                     push(@implContent, "    if (thisObject->putDelegate(state, propertyName, value, slot, putResult))\n");
2708                     push(@implContent, "        return putResult;\n");
2709                 }
2710
2711                 push(@implContent, "    return Base::putByIndex(cell, state, index, value, shouldThrow);\n");
2712                 push(@implContent, "}\n\n");
2713             }
2714         }
2715     }
2716
2717     foreach my $attribute (@{$interface->attributes}) {
2718         if (!IsReadonly($attribute)) {
2719             next if IsJSBuiltin($interface, $attribute);
2720
2721             my $name = $attribute->signature->name;
2722             my $type = $attribute->signature->type;
2723             my $putFunctionName = GetAttributeSetterName($interfaceName, $className, $interface, $attribute);
2724             my $implSetterFunctionName = $codeGenerator->WK_ucfirst($name);
2725             my $setterRaisesExceptionWithMessage = $attribute->signature->extendedAttributes->{"SetterRaisesExceptionWithMessage"};
2726             my $setterRaisesException = $attribute->signature->extendedAttributes->{"SetterRaisesException"} || $setterRaisesExceptionWithMessage;
2727
2728             if ($setterRaisesException) {
2729                 $implIncludes{"ExceptionCode.h"} = 1;
2730             }
2731
2732             my $attributeConditionalString = $codeGenerator->GenerateConditionalString($attribute->signature);
2733             push(@implContent, "#if ${attributeConditionalString}\n") if $attributeConditionalString;
2734
2735             push(@implContent, "bool ${putFunctionName}(ExecState* state, EncodedJSValue thisValue, EncodedJSValue encodedValue)\n");
2736             push(@implContent, "{\n");
2737             push(@implContent, "    JSValue value = JSValue::decode(encodedValue);\n");
2738             push(@implContent, "    UNUSED_PARAM(thisValue);\n") if !$attribute->isStatic;
2739             if (!$attribute->isStatic) {
2740                 if ($interface->extendedAttributes->{"CustomProxyToJSObject"}) {
2741                     push(@implContent, "    ${className}* castedThis = to${className}(JSValue::decode(thisValue));\n");
2742                 } else {
2743                     push(@implContent, "    ${className}* castedThis = " . GetCastingHelperForThisObject($interface) . "(JSValue::decode(thisValue));\n");
2744                 }
2745                 push(@implContent, "    if (UNLIKELY(!castedThis)) {\n");
2746                 if ($attribute->signature->extendedAttributes->{"LenientThis"}) {
2747                     push(@implContent, "        return false;\n");
2748                 } elsif (InterfaceRequiresAttributesOnInstanceForCompatibility($interface)) {
2749                     # Fallback to trying to searching the prototype chain for compatibility reasons.
2750                     push(@implContent, "        JSObject* thisObject = JSValue::decode(thisValue).getObject();\n");
2751                     push(@implContent, "        for (thisObject = thisObject ? thisObject->getPrototypeDirect().getObject() : nullptr; thisObject; thisObject = thisObject->getPrototypeDirect().getObject()) {\n");
2752                     push(@implContent, "            if ((castedThis = " . GetCastingHelperForThisObject($interface) . "(thisObject)))\n");
2753                     push(@implContent, "                break;\n");
2754                     push(@implContent, "        }\n");
2755                     push(@implContent, "        if (!castedThis)\n");
2756                     push(@implContent, "            return throwSetterTypeError(*state, \"$interfaceName\", \"$name\");\n");
2757                     push(@implContent, "        reportDeprecatedSetterError(*state, \"$interfaceName\", \"$name\");\n");
2758                 } else {
2759                     push(@implContent, "        return throwSetterTypeError(*state, \"$interfaceName\", \"$name\");\n");
2760                 }
2761                 push(@implContent, "    }\n");
2762             }
2763             if ($interface->extendedAttributes->{"CheckSecurity"} && !$attribute->signature->extendedAttributes->{"DoNotCheckSecurity"}) {
2764                 if ($interfaceName eq "DOMWindow") {
2765                     push(@implContent, "    if (!BindingSecurity::shouldAllowAccessToDOMWindow(state, castedThis->wrapped()))\n");
2766                 } else {
2767                     push(@implContent, "    if (!shouldAllowAccessToFrame(state, castedThis->wrapped().frame()))\n");
2768                 }
2769                 push(@implContent, "        return false;\n");
2770             }
2771
2772             if (HasCustomSetter($attribute->signature->extendedAttributes)) {
2773                 push(@implContent, "    castedThis->set$implSetterFunctionName(*state, value);\n");
2774                 push(@implContent, "    return true;\n");
2775             } elsif ($type eq "EventHandler") {
2776                 $implIncludes{"JSEventListener.h"} = 1;
2777                 my $eventName = EventHandlerAttributeEventName($attribute);
2778                 # FIXME: Find a way to do this special case without hardcoding the class and attribute names here.
2779                 if ((($interfaceName eq "DOMWindow") or ($interfaceName eq "WorkerGlobalScope")) and $name eq "onerror") {
2780                     $implIncludes{"JSErrorHandler.h"} = 1;
2781                     push(@implContent, "    castedThis->wrapped().setAttributeEventListener($eventName, createJSErrorHandler(state, value, castedThis));\n");
2782                 } else {
2783                     $implIncludes{"JSEventListener.h"} = 1;
2784                     my $setter = $attribute->signature->extendedAttributes->{"WindowEventHandler"} ? "setWindowEventHandlerAttribute"
2785                         : $attribute->signature->extendedAttributes->{"DocumentEventHandler"} ? "setDocumentEventHandlerAttribute"
2786                         : "setEventHandlerAttribute";
2787                     push(@implContent, "    $setter(*state, *castedThis, castedThis->wrapped(), $eventName, value);\n");
2788                 }
2789                 push(@implContent, "    return true;\n");
2790             } elsif ($type =~ /Constructor$/) {
2791                 my $constructorType = $type;
2792                 $constructorType =~ s/Constructor$//;
2793                 # $constructorType ~= /Constructor$/ indicates that it is NamedConstructor.
2794                 # We do not generate the header file for NamedConstructor of class XXXX,
2795                 # since we generate the NamedConstructor declaration into the header file of class XXXX.
2796                 if ($constructorType ne "any" and $constructorType !~ /Named$/) {
2797                     AddToImplIncludes("JS" . $constructorType . ".h", $attribute->signature->extendedAttributes->{"Conditional"});
2798                 }
2799                 push(@implContent, "    // Shadowing a built-in constructor.\n");
2800                 push(@implContent, "    return castedThis->putDirect(state->vm(), Identifier::fromString(state, \"$name\"), value);\n");
2801             } elsif ($attribute->signature->extendedAttributes->{"Replaceable"}) {
2802                 push(@implContent, "    // Shadowing a built-in object.\n");
2803                 push(@implContent, "    return castedThis->putDirect(state->vm(), Identifier::fromString(state, \"$name\"), value);\n");
2804             } else {
2805                 if (!$attribute->isStatic) {
2806                     my $putForwards = $attribute->signature->extendedAttributes->{"PutForwards"};
2807                     if ($putForwards) {
2808                         my $implGetterFunctionName = $codeGenerator->WK_lcfirst($attribute->signature->extendedAttributes->{"ImplementedAs"} || $name);
2809                         if ($attribute->signature->isNullable) {
2810                             push(@implContent, "    RefPtr<${type}> forwardedImpl = castedThis->wrapped().${implGetterFunctionName}();\n");
2811                             push(@implContent, "    if (!forwardedImpl)\n");
2812                             push(@implContent, "        return false;\n");
2813                             push(@implContent, "    auto& impl = *forwardedImpl;\n");
2814                         } else {
2815                             # Attribute is not nullable, the implementation is expected to return a reference.
2816                             push(@implContent, "    Ref<${type}> forwardedImpl = castedThis->wrapped().${implGetterFunctionName}();\n");
2817                             push(@implContent, "    auto& impl = forwardedImpl.get();\n");
2818                         }
2819                         $attribute = $codeGenerator->GetAttributeFromInterface($interface, $type, $putForwards);
2820                     } else {
2821                         push(@implContent, "    auto& impl = castedThis->wrapped();\n");
2822                     }
2823                 }
2824                 if ($setterRaisesExceptionWithMessage) {
2825                     push(@implContent, "    ExceptionCodeWithMessage ec;\n");
2826                 } elsif ($setterRaisesException) {
2827                     push(@implContent, "    ExceptionCode ec = 0;\n");
2828                 }
2829
2830                 # If the "StrictTypeChecking" extended attribute is present, and the attribute's type is an
2831                 # interface type, then if the incoming value does not implement that interface, a TypeError
2832                 # is thrown rather than silently passing NULL to the C++ code.
2833                 # Per the Web IDL and ECMAScript specifications, incoming values can always be converted to
2834                 # both strings and numbers, so do not throw TypeError if the attribute is of these types.
2835                 if ($codeGenerator->IsWrapperType($type) && $attribute->signature->extendedAttributes->{"StrictTypeChecking"}) {
2836                     $implIncludes{"<runtime/Error.h>"} = 1;
2837                     push(@implContent, "    if (UNLIKELY(!value.isUndefinedOrNull() && !value.inherits(JS${type}::info()))) {\n");
2838                     push(@implContent, "        throwAttributeTypeError(*state, \"$interfaceName\", \"$name\", \"$type\");\n");
2839                     push(@implContent, "        return false;\n");
2840                     push(@implContent, "    };\n");
2841                 }
2842
2843                 push(@implContent, "    " . GetNativeTypeFromSignature($attribute->signature) . " nativeValue = " . JSValueToNative($attribute->signature, "value", $attribute->signature->extendedAttributes->{"Conditional"}) . ";\n");
2844                 push(@implContent, "    if (UNLIKELY(state->hadException()))\n");
2845                 push(@implContent, "        return false;\n");
2846
2847                 if ($codeGenerator->IsEnumType($type)) {
2848                     push (@implContent, "    if (UNLIKELY(!nativeValue))\n");
2849                     push (@implContent, "        return false;\n");
2850                 }
2851
2852                 my $shouldPassByReference = ShouldPassWrapperByReference($attribute->signature, $interface);
2853                 if ($shouldPassByReference) {
2854                     push(@implContent, "    if (UNLIKELY(!nativeValue)) {\n");
2855                     push(@implContent, "        throwVMTypeError(state);\n");
2856                     push(@implContent, "        return false;\n");
2857                     push(@implContent, "    }\n");
2858                 }
2859
2860                 if ($type eq "double" or $type eq "float") {
2861                     push(@implContent, "    if (UNLIKELY(!std::isfinite(nativeValue))) {\n");
2862                     push(@implContent, "        throwVMTypeError(state);\n");
2863                     push(@implContent, "        return false;\n");
2864                     push(@implContent, "    }\n");
2865                 }
2866
2867                 if ($svgPropertyOrListPropertyType) {
2868                     if ($svgPropertyType) {
2869                         push(@implContent, "    if (impl.isReadOnly()) {\n");
2870                         push(@implContent, "        setDOMException(state, NO_MODIFICATION_ALLOWED_ERR);\n");
2871                         push(@implContent, "        return false;\n");
2872                         push(@implContent, "    }\n");
2873                         $implIncludes{"ExceptionCode.h"} = 1;
2874                     }
2875                     push(@implContent, "    $svgPropertyOrListPropertyType& podImpl = impl.propertyReference();\n");
2876                     if ($svgPropertyOrListPropertyType eq "float") { # Special case for JSSVGNumber
2877                         push(@implContent, "    podImpl = nativeValue;\n");
2878                     } else {
2879                         push(@implContent, "    podImpl.set$implSetterFunctionName(nativeValue");
2880                         push(@implContent, ", ec") if $setterRaisesException;
2881                         push(@implContent, ");\n");
2882                         push(@implContent, "    setDOMException(state, ec);\n") if $setterRaisesException;
2883                     }
2884                     if ($svgPropertyType) {
2885                         if ($setterRaisesExceptionWithMessage) {
2886                             push(@implContent, "    if (LIKELY(!ec.code))\n");
2887                             push(@implContent, "        impl.commitChange();\n");
2888                         } elsif ($setterRaisesException) {
2889                             push(@implContent, "    if (LIKELY(!ec))\n");
2890                             push(@implContent, "        impl.commitChange();\n");
2891                         } else {
2892                             push(@implContent, "    impl.commitChange();\n");
2893                         }
2894                     }
2895                     push(@implContent, "    return true;\n");
2896                 } else {
2897                     my ($functionName, @arguments) = $codeGenerator->SetterExpression(\%implIncludes, $interfaceName, $attribute);
2898                     if ($codeGenerator->IsTypedArrayType($type) and not $type eq "ArrayBuffer") {
2899                         push(@arguments, "nativeValue.get()");
2900                     } elsif ($codeGenerator->IsEnumType($type)) {
2901                         push(@arguments, "nativeValue.value()");
2902                     } else {
2903                         push(@arguments, $shouldPassByReference ? "*nativeValue" : "nativeValue");
2904                     }
2905                     if ($attribute->signature->extendedAttributes->{"ImplementedBy"}) {
2906                         my $implementedBy = $attribute->signature->extendedAttributes->{"ImplementedBy"};
2907                         AddToImplIncludes("${implementedBy}.h", $attribute->signature->extendedAttributes->{"Conditional"});
2908                         unshift(@arguments, "impl") if !$attribute->isStatic;
2909                         $functionName = "WebCore::${implementedBy}::${functionName}";
2910                     } elsif ($attribute->isStatic) {
2911                         $functionName = "${interfaceName}::${functionName}";
2912                     } else {
2913                         $functionName = "impl.${functionName}";
2914                     }
2915
2916                     unshift(@arguments, GenerateCallWith($attribute->signature->extendedAttributes->{"SetterCallWith"}, \@implContent, "false"));
2917                     unshift(@arguments, GenerateCallWith($attribute->signature->extendedAttributes->{"CallWith"}, \@implContent, "false"));
2918
2919                     push(@arguments, "ec") if $setterRaisesException;
2920                     push(@implContent, "    ${functionName}(" . join(", ", @arguments) . ");\n");
2921                     push(@implContent, "    setDOMException(state, ec);\n") if $setterRaisesException;
2922                     push(@implContent, "    return true;\n");
2923                 }
2924             }
2925
2926             push(@implContent, "}\n\n");
2927             push(@implContent, "#endif\n") if $attributeConditionalString;
2928             push(@implContent, "\n");
2929         }
2930     }
2931
2932     if (($indexedGetterFunction || $namedGetterFunction) && !$interface->extendedAttributes->{"CustomEnumerateProperty"}) {
2933         push(@implContent, "void ${className}::getOwnPropertyNames(JSObject* object, ExecState* state, PropertyNameArray& propertyNames, EnumerationMode mode)\n");
2934         push(@implContent, "{\n");
2935         push(@implContent, "    auto* thisObject = jsCast<${className}*>(object);\n");
2936         push(@implContent, "    ASSERT_GC_OBJECT_INHERITS(thisObject, info());\n");
2937         if ($indexedGetterFunction) {
2938             push(@implContent, "    for (unsigned i = 0, count = thisObject->wrapped().length(); i < count; ++i)\n");
2939             push(@implContent, "        propertyNames.add(Identifier::from(state, i));\n");
2940         }
2941         if ($namedGetterFunction) {
2942             # FIXME: We may need to add an IDL extended attribute at some point if an interface needs enumerable named properties.
2943             push(@implContent, "    if (mode.includeDontEnumProperties()) {\n");
2944             push(@implContent, "        for (auto& propertyName : thisObject->wrapped().supportedPropertyNames())\n");
2945             push(@implContent, "            propertyNames.add(Identifier::fromString(state, propertyName));\n");
2946             push(@implContent, "    }\n");
2947         }
2948         push(@implContent, "    Base::getOwnPropertyNames(thisObject, state, propertyNames, mode);\n");
2949         push(@implContent, "}\n\n");
2950     }
2951
2952     if (!$interface->extendedAttributes->{"NoInterfaceObject"}) {
2953         push(@implContent, "JSValue ${className}::getConstructor(VM& vm, const JSGlobalObject* globalObject)\n{\n");
2954         push(@implContent, "    return getDOMConstructor<${className}Constructor>(vm, *jsCast<const JSDOMGlobalObject*>(globalObject));\n");
2955         push(@implContent, "}\n\n");
2956         if ($interface->extendedAttributes->{"NamedConstructor"}) {
2957             push(@implContent, "JSValue ${className}::getNamedConstructor(VM& vm, JSGlobalObject* globalObject)\n{\n");
2958             push(@implContent, "    return getDOMConstructor<${className}NamedConstructor>(vm, *jsCast<JSDOMGlobalObject*>(globalObject));\n");
2959             push(@implContent, "}\n\n");
2960         }
2961     }
2962
2963     # Functions
2964     if ($numFunctions > 0) {
2965         my $inAppleCopyright = 0;
2966         foreach my $function (@{$interface->functions}) {
2967             next if IsJSBuiltin($interface, $function);
2968             my $needsAppleCopyright = $function->signature->extendedAttributes->{"AppleCopyright"};
2969             if ($needsAppleCopyright) {
2970                 if (!$inAppleCopyright) {
2971                     push(@implContent, $beginAppleCopyrightForSourceFiles);
2972                     $inAppleCopyright = 1;
2973                 }
2974             } elsif ($inAppleCopyright) {
2975                 push(@implContent, $endAppleCopyright);
2976                 $inAppleCopyright = 0;
2977             }
2978
2979             my $isCustom = HasCustomMethod($function->signature->extendedAttributes);
2980             my $isOverloaded = $function->{overloads} && @{$function->{overloads}} > 1;
2981
2982             die "RaisesException and RaisesExceptionWithMessage are mutually exclusive" if $function->signature->extendedAttributes->{"RaisesException"} && $function->signature->extendedAttributes->{"RaisesExceptionWithMessage"};
2983
2984             my $raisesExceptionWithMessage = $function->signature->extendedAttributes->{"RaisesExceptionWithMessage"};
2985             my $raisesException = $function->signature->extendedAttributes->{"RaisesException"} || $raisesExceptionWithMessage;
2986
2987             next if $isCustom && $isOverloaded && $function->{overloadIndex} > 1;
2988
2989             AddIncludesForTypeInImpl($function->signature->type) unless $isCustom or IsReturningPromise($function);
2990
2991             my $functionName = GetFunctionName($interface, $className, $function);
2992
2993             my $conditional = $function->signature->extendedAttributes->{"Conditional"};
2994             if ($conditional) {
2995                 my $conditionalString = $codeGenerator->GenerateConditionalStringFromAttributeValue($conditional);
2996                 push(@implContent, "#if ${conditionalString}\n");
2997             }