feat: add isShadowRoot

DOC.md

@@ -8971,6 +8971,28 @@ isSet(new Set()); // -> true
 isSet(new WeakSet()); // -> false
 ```
 
+## isShadowRoot 
+
+Check if value is a ShadowRoot object.
+
+<details>
+<summary>Type Definition</summary>
+
+```typescript
+function isShadowRoot(val: any): val is ShadowRoot;
+```
+
+</details>
+
+|Name  |Desc                         |
+|------|-----------------------------|
+|val   |Value to check               |
+|return|True if value is a ShadowRoot|
+
+```javascript
+isShadowRoot(document.body); // -> false
+```
+
 ## isSorted 
 
 Check if an array is sorted.

DOC_CN.md

@@ -8964,6 +8964,28 @@ isSet(new Set()); // -> true
 isSet(new WeakSet()); // -> false
 ```
 
+## isShadowRoot
+
+检查值是否是 ShadowRoot 对象。
+
+<details>
+<summary>类型定义</summary>
+
+```typescript
+function isShadowRoot(val: any): val is ShadowRoot;
+```
+
+</details>
+
+|参数名|说明|
+|-----|---|
+|val|要检查的值|
+|返回值|如果是 ShadowRoot，返回真|
+
+```javascript
+isShadowRoot(document.body); // -> false
+```
+
 ## isSorted
 
 检查数组是否有序。

cspell.json

@@ -239,6 +239,7 @@
     "isRetina",
     "isRunning",
     "isSet",
+    "isShadowRoot",
     "isSorted",
     "isStr",
     "isStrBlank",

i18n/isShadowRoot.md

@@ -0,0 +1,8 @@
+## CN
+
+检查值是否是 ShadowRoot 对象。
+
+|参数名|说明|
+|-----|---|
+|val|要检查的值|
+|返回值|如果是 ShadowRoot，返回真|

index.json

@@ -4067,6 +4067,16 @@
             "browser"
         ]
     },
+    "isShadowRoot": {
+        "dependencies": [],
+        "description": "Check if value is a ShadowRoot object.",
+        "env": [
+            "browser"
+        ],
+        "test": [
+            "browser"
+        ]
+    },
     "isSorted": {
         "dependencies": [],
         "description": "Check if an array is sorted.",

src/isShadowRoot.js

@@ -0,0 +1,27 @@
+/* Check if value is a ShadowRoot object.
+ *
+ * |Name  |Desc                         |
+ * |------|-----------------------------|
+ * |val   |Value to check               |
+ * |return|True if value is a ShadowRoot|
+ */
+
+/* example
+ * isShadowRoot(document.body); // -> false
+ */
+
+/* module
+ * env: browser
+ */
+
+/* typescript
+ * export declare function isShadowRoot(val: any): val is ShadowRoot;
+ */
+
+exports = function(val) {
+    if (window.ShadowRoot) {
+        return val instanceof ShadowRoot;
+    }
+
+    return false;
+};

test/isShadowRoot.js

@@ -0,0 +1,12 @@
+it('true', function() {
+    expect(
+        isShadowRoot(
+            document.createElement('div').attachShadow({ mode: 'open' })
+        )
+    ).to.be.true;
+});
+
+it('false', function() {
+    expect(isShadowRoot(document.body)).to.be.false;
+    expect(isShadowRoot(document.createElement('div'))).to.be.false;
+});