Web Automation: upstream safaridriver's JavaScript atom implementations
[WebKit.git] / Source / WebKit2 / UIProcess / Automation / atoms / ElementAttribute.js
1 /*
2  * Copyright (C) 2017 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
14  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
17  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
23  * THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 function(element, attributeName) {
27     "use strict";
28
29     let lowercaseAttributeName = attributeName.toLowerCase();
30     let tagName = element.tagName.toUpperCase();
31
32     // Special Case: "selected" / "checked" work analogously
33     // on options and checkboxes.
34     if (lowercaseAttributeName === "selected" || lowercaseAttributeName === "checked") {
35         switch (tagName) {
36         case "OPTION":
37             return element.selected ? "true" : null;
38         case "INPUT":
39             if (element.type === "checkbox" || element.type === "radio")
40                 return element.checked ? "true" : null;
41             break;
42         }
43     }
44
45     // Special Case: For images and links, require the existence of
46     // the attribute before accessing the property.
47     if ((tagName === "IMG" && lowercaseAttributeName === "src") || (tagName === "A" && lowercaseAttributeName === "href")) {
48         let value = element.getAttribute(lowercaseAttributeName);
49         return value ? element[lowercaseAttributeName] : value;
50     }
51
52     // Prefer the element's property over the attribute if the
53     // property value is not null and not an object. For boolean
54     // properties return null if false.
55     try {
56         const propertyNameAliases = {"class": "className", "readonly": "readOnly"};
57         let propertyName = propertyNameAliases[attributeName] || attributeName;
58         let value = element[propertyName];
59         if (value != null && typeof value !== "object") {
60             if (typeof value === "boolean")
61                 return value ? "true" : null;
62             return value.toString();
63         }
64     } catch (e) { }
65
66     return element.getAttribute(attributeName);
67 }