ms-vite-plugin 1.1.2 → 1.1.4

package/docs/apipython/ui.md

@@ -0,0 +1,949 @@
+# UI 模块 (UI)
+
+UI 模块提供 WebView 相关功能，支持事件通信与 JavaScript 交互。该模块使用共享的 WebView 实例，通过静态方法进行操作。
+
+## UI 设计器
+
+- <a href="/designer/index.html" target="_blank">在线设计器</a>
+
+## 注意事项
+
+- UI 相关方法仅 app 在前台可用
+
+## 配置
+
+### UI 配置 网页会自动加载 package.json 中的配置
+
+在 `package.json` 中添加以下配置：
+
+```json
+{
+  "ui": {
+    "tabs": [
+      {
+        "name": "快点JS",
+        "file": "index.html"
+      }
+    ]
+  }
+}
+```
+
+### 配置项
+
+- `tabs` - 网页标签配置数组
+  - `name` - 标签名称
+  - `file` - 网页文件路径（基于 res 目录）
+
+### 多个标签页
+
+如果配置了多个标签页，每个标签页会对应一个网页文件。在 `package.json` 中添加多个标签页配置即可。
+
+```json
+{
+  "ui": {
+    "tabs": [
+      {
+        "name": "快点JS",
+        "file": "index.html"
+      },
+      {
+        "name": "设置",
+        "file": "settings.html"
+      }
+    ]
+  }
+}
+```
+
+### 不显示标题栏
+
+如果只有一个页面且不需要标题栏，配置为空数组，会自动加载 `index.html`：
+
+```json
+{
+  "ui": {
+    "tabs": []
+  }
+}
+```
+
+## 核心方法
+
+### onEvent - 设置事件回调函数
+
+```python
+from typing import Callable, Any
+
+def onEvent(callback: Callable[[str, Any], None]) -> None
+```
+
+**参数：**
+
+| 参数名     | 类型                         | 是否必填 | 默认值 | 描述                                 |
+| ---------- | ---------------------------- | -------- | ------ | ------------------------------------ |
+| `callback` | `Callable[[str, Any], None]` | 是       |        | 事件回调函数，用于处理来自网页的事件 |
+
+**示例：**
+
+```python
+from kuaijs import ui, logger
+import json
+
+def handle_event(event: str, data: Any):
+    logger.info(f"收到事件: {event}, 数据: {json.dumps(data)}")
+
+ui.onEvent(handle_event)
+```
+
+### call - 调用 WebView 中的 JavaScript 函数
+
+```python
+def call(key: str, data: dict) -> None
+```
+
+**参数：**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述              |
+| ------ | ---- | -------- | ------ | ----------------- |
+| `key`  | str  | 是       |        | JavaScript 方法名 |
+| `data` | dict | 是       |        | 传递给方法的参数  |
+
+**示例：**
+
+```python
+from kuaijs import ui
+import time
+
+# 调用网页中的方法
+ui.call("updateStatus", {"status": "running", "progress": 50})
+ui.call("loadData", {
+    "items": ["item1", "item2", "item3"],
+    "timestamp": int(time.time() * 1000)
+})
+```
+
+### showToast - 显示 Toast 提示消息
+
+```python
+def showToast(message: str) -> None
+```
+
+**参数：**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述         |
+| --------- | ---- | -------- | ------ | ------------ |
+| `message` | str  | 是       |        | 提示消息内容 |
+
+**示例：**
+
+```python
+from kuaijs import ui
+
+# 显示成功提示
+ui.showToast("操作成功")
+
+# 显示错误提示
+ui.showToast("网络连接失败，请重试")
+
+# 显示信息提示
+ui.showToast("数据已保存")
+```
+
+### confirm - 显示确认对话框
+
+```python
+def confirm(title: str, message: str) -> bool
+```
+
+**参数：**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述       |
+| --------- | ---- | -------- | ------ | ---------- |
+| `title`   | str  | 是       |        | 对话框标题 |
+| `message` | str  | 是       |        | 对话框内容 |
+
+**返回值：**
+
+| 类型   | 描述                                        |
+| ------ | ------------------------------------------- |
+| `bool` | 用户选择结果，确定返回 True，取消返回 False |
+
+**示例：**
+
+```python
+from kuaijs import ui, logger, file
+
+# 显示确认对话框
+result = ui.confirm("确认删除", "是否确定要删除这个文件？")
+if result:
+    logger.info("用户确认删除")
+    # 执行删除操作
+    # file.delete_all_file("temp.txt")
+else:
+    logger.info("用户取消删除")
+
+# 确认退出应用
+should_exit = ui.confirm("退出应用", "确定要退出快点JS吗？")
+if should_exit:
+    # 执行退出逻辑
+    pass
+```
+
+### confirmInput - 显示输入对话框
+
+```python
+def confirmInput(title: str, message: str) -> str
+```
+
+**参数：**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述       |
+| --------- | ---- | -------- | ------ | ---------- |
+| `title`   | str  | 是       |        | 对话框标题 |
+| `message` | str  | 是       |        | 对话框内容 |
+
+**返回值：**
+
+| 类型  | 描述                           |
+| ----- | ------------------------------ |
+| `str` | 用户输入内容；取消返回空字符串 |
+
+**示例：**
+
+```python
+from kuaijs import ui, logger, config
+
+# 获取用户输入
+username = ui.confirmInput("用户登录", "请输入您的用户名：")
+if username:
+    logger.info(f"用户输入的用户名：{username}")
+    # 继续登录流程
+else:
+    logger.info("用户取消了输入")
+
+# 获取配置值
+api_url = ui.confirmInput("API配置", "请输入API服务器地址：")
+if api_url:
+    config.set_config("apiUrl", api_url)
+    ui.showToast("API地址配置成功")
+```
+
+### alert - 显示警告对话框
+
+```python
+def alert(title: str, message: str) -> None
+```
+
+**参数：**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述       |
+| --------- | ---- | -------- | ------ | ---------- |
+| `title`   | str  | 是       |        | 对话框标题 |
+| `message` | str  | 是       |        | 对话框内容 |
+
+**示例：**
+
+```python
+from kuaijs import ui
+
+# 显示错误警告
+ui.alert("错误", "网络连接失败，请检查网络设置")
+
+# 显示重要提示
+ui.alert("重要提示", "请确保设备已连接到电脑并信任此设备")
+
+# 显示操作结果
+ui.alert("操作完成", "脚本执行完成，共处理了100个项目")
+```
+
+## 网页端 API
+
+以下 API 是在网页端 JavaScript 中使用的，用于与 Python 脚本交互。
+
+### registerUIFunc - 在网页中注册函数，供主进程调用
+
+```typescript
+declare function registerUIFunc(
+  name: string,
+  func: (data: Record<string, any>) => void
+): void;
+```
+
+**参数：**
+
+| 参数名 | 类型     | 是否必填 | 默认值 | 描述     |
+| ------ | -------- | -------- | ------ | -------- |
+| `name` | string   | 是       |        | 函数名称 |
+| `func` | function | 是       |        | 函数实现 |
+
+**网页端示例：**
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>快点JS UI</title>
+  </head>
+  <body>
+    <div id="status">等待中...</div>
+    <button onclick="sendMessage()">发送消息</button>
+
+    <script>
+      // 注册供主进程调用的函数
+      ms.registerUIFunc("updateStatus", function (data) {
+        document.getElementById(
+          "status"
+        ).textContent = `状态: ${data.status}, 进度: ${data.progress}%`;
+      });
+
+      ms.registerUIFunc("loadData", function (data) {
+        console.log(`收到数据: ${JSON.stringify(data)}`);
+        // 更新界面显示数据
+        updateUI(data.items);
+      });
+
+      function sendMessage() {
+        ms.emitEvent("button.click", {
+          buttonId: "send",
+          timestamp: Date.now(),
+        });
+      }
+
+      function updateUI(items) {
+        // 更新界面逻辑
+      }
+    </script>
+  </body>
+</html>
+```
+
+### emitEvent - 从网页向主进程发送事件
+
+```typescript
+declare function emitEvent(event: string, data: Record<string, any>): void;
+```
+
+**参数：**
+
+- `event` - 事件名称
+- `data` - 事件数据
+
+**网页端示例：**
+
+```javascript
+// 发送自定义事件
+ms.emitEvent("user.login", { username: "admin", timestamp: Date.now() });
+
+// 发送操作完成事件
+ms.emitEvent("task.completed", { taskId: "task001", result: "success" });
+
+// 发送错误事件
+ms.emitEvent("error.occurred", { message: "网络连接失败", code: 500 });
+```
+
+### startTask - 启动脚本
+
+```typescript
+declare function startTask(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果启动成功返回 true，否则返回 false |
+
+**说明：**
+
+启动脚本任务。
+
+**网页端示例：**
+
+```javascript
+// 启动脚本
+ms.startTask()
+  .then((result) => {
+    if (result) {
+      console.log("脚本启动成功");
+    } else {
+      console.log("脚本启动失败");
+    }
+  })
+  .catch((error) => {
+    console.error("启动脚本出错:", error);
+  });
+```
+
+### stopTask - 停止脚本
+
+```typescript
+declare function stopTask(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果停止成功返回 false，否则返回 true |
+
+**说明：**
+
+停止当前运行的脚本任务。
+
+**网页端示例：**
+
+```javascript
+// 停止脚本
+ms.stopTask()
+  .then((result) => {
+    if (!result) {
+      console.log("脚本停止成功");
+    } else {
+      console.log("脚本停止失败");
+    }
+  })
+  .catch((error) => {
+    console.error("停止脚本出错:", error);
+  });
+```
+
+### isTaskRunning - 检查脚本运行状态
+
+```typescript
+declare function isTaskRunning(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                      |
+| ------------------ | ----------------------------------------- |
+| `Promise<boolean>` | 如果脚本正在运行返回 true，否则返回 false |
+
+**说明：**
+
+检查脚本是否正在运行。
+
+**网页端示例：**
+
+```javascript
+// 检查脚本状态
+ms.isTaskRunning()
+  .then((isRunning) => {
+    if (isRunning) {
+      console.log("脚本正在运行");
+      document.getElementById("task-status").textContent = "运行中";
+    } else {
+      console.log("脚本未运行");
+      document.getElementById("task-status").textContent = "已停止";
+    }
+  })
+  .catch((error) => {
+    console.error("获取脚本状态出错:", error);
+  });
+```
+
+### 配置管理方法
+
+#### setConfig - 设置配置项
+
+```typescript
+declare function setConfig(key: string, value: any): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名  | 类型   | 是否必填 | 默认值 | 描述     |
+| ------- | ------ | -------- | ------ | -------- |
+| `key`   | string | 是       |        | 配置项键 |
+| `value` | any    | 是       |        | 配置项值 |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果设置成功返回 true，否则返回 false |
+
+**网页端示例：**
+
+```javascript
+// 设置配置项
+ms.setConfig("theme", "dark").then((success) => {
+  if (success) {
+    console.log("配置设置成功");
+  }
+});
+```
+
+#### getConfig - 获取配置项
+
+```typescript
+declare function getConfig(key: string): Promise<any>;
+```
+
+**参数：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述     |
+| ------ | ------ | -------- | ------ | -------- |
+| `key`  | string | 是       |        | 配置项键 |
+
+**返回值：**
+
+| 类型           | 描述     |
+| -------------- | -------- |
+| `Promise<any>` | 配置项值 |
+
+**网页端示例：**
+
+```javascript
+// 获取配置项
+ms.getConfig("theme").then((value) => {
+  console.log("当前主题:", value);
+});
+```
+
+#### removeConfig - 移除配置项
+
+```typescript
+declare function removeConfig(key: string): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述     |
+| ------ | ------ | -------- | ------ | -------- |
+| `key`  | string | 是       |        | 配置项键 |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果移除成功返回 true，否则返回 false |
+
+**网页端示例：**
+
+```javascript
+// 移除配置项
+ms.removeConfig("theme").then((success) => {
+  if (success) {
+    console.log("配置移除成功");
+  }
+});
+```
+
+#### getAllConfig - 获取所有配置
+
+```typescript
+declare function getAllConfig(): Promise<Record<string, any>>;
+```
+
+**返回值：**
+
+| 类型                           | 描述               |
+| ------------------------------ | ------------------ |
+| `Promise<Record<string, any>>` | 包含所有配置的字典 |
+
+**网页端示例：**
+
+```javascript
+// 获取所有配置
+ms.getAllConfig().then((configs) => {
+  console.log("所有配置:", configs);
+});
+```
+
+### 快点 Agent 控制方法
+
+#### startAgent - 启动 快点 Agent 服务
+
+```typescript
+declare function startAgent(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果调用成功返回 true，否则返回 false |
+
+**说明：**
+
+启动 快点 Agent 服务。注意：返回值仅表示调用是否成功，不代表 快点 Agent 服务是否启动成功。
+
+**网页端示例：**
+
+```javascript
+// 启动 快点 Agent 服务
+ms.startAgent()
+  .then((result) => {
+    if (result) {
+      console.log("快点 Agent 启动调用成功");
+      // 可以通过 getAgentStatus() 检查实际状态
+      checkAgentStatus();
+    } else {
+      console.log("快点 Agent 启动调用失败");
+    }
+  })
+  .catch((error) => {
+    console.error("快点 Agent 启动出错:", error);
+  });
+```
+
+#### getAgentStatus - 获取 快点 Agent 状态
+
+```typescript
+declare function getAgentStatus(): Promise<boolean>;
+```
+
+**返回值：**
+
+| 类型               | 描述                                              |
+| ------------------ | ------------------------------------------------- |
+| `Promise<boolean>` | 如果 快点 Agent 正在运行返回 true，否则返回 false |
+
+**说明：**
+
+检查 快点 Agent 服务的当前运行状态。
+
+**网页端示例：**
+
+```javascript
+// 检查 快点 Agent 状态
+ms.getAgentStatus()
+  .then((isRunning) => {
+    if (isRunning) {
+      console.log("快点 Agent 服务正在运行");
+      document.getElementById("agent-status").textContent = "已连接";
+      document.getElementById("agent-status").className = "status-online";
+    } else {
+      console.log("快点 Agent 服务未运行");
+      document.getElementById("agent-status").textContent = "未连接";
+      document.getElementById("agent-status").className = "status-offline";
+    }
+  })
+  .catch((error) => {
+    console.error("获取 快点 Agent 状态出错:", error);
+  });
+
+// 定期检查 快点 Agent 状态
+function checkAgentStatus() {
+  ms.getAgentStatus().then((isRunning) => {
+    updateAgentStatusUI(isRunning);
+  });
+}
+
+// 每 5 秒检查一次状态
+setInterval(checkAgentStatus, 5000);
+```
+
+### 系统功能
+
+#### getServerDeviceId - 获取服务器设备 ID
+
+```typescript
+declare function getServerDeviceId(): Promise<string>;
+```
+
+**返回值：**
+
+| 类型              | 描述          |
+| ----------------- | ------------- |
+| `Promise<string>` | 服务器设备 ID |
+
+**说明：**
+
+获取当前运行脚本的服务器设备 ID。
+
+**网页端示例：**
+
+```javascript
+// 获取服务器设备ID
+ms.getServerDeviceId()
+  .then((deviceId) => {
+    console.log("当前服务器设备ID:", deviceId);
+  })
+  .catch((error) => {
+    console.error("获取服务器设备ID出错:", error);
+  });
+```
+
+#### openURL - 调用浏览器打开 URL
+
+```typescript
+declare function openURL(url: string): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述              |
+| ------ | ------ | -------- | ------ | ----------------- |
+| `url`  | string | 是       |        | 要打开的 URL 地址 |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果调用成功返回 true，否则返回 false |
+
+**说明：**
+
+打开指定的 URL 地址。
+
+**网页端示例：**
+
+```javascript
+// 打开URL
+ms.openURL("https://www.baidu.com")
+  .then((success) => {
+    if (success) {
+      console.log("URL打开成功");
+    } else {
+      console.log("URL打开失败");
+    }
+  })
+  .catch((error) => {
+    console.error("打开URL出错:", error);
+  });
+```
+
+### 完整示例
+
+**完整的控制面板示例：**
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>快点JS 控制面板</title>
+    <style>
+      .status-online {
+        color: green;
+      }
+      .status-offline {
+        color: red;
+      }
+      .button {
+        padding: 10px 20px;
+        margin: 5px;
+        cursor: pointer;
+      }
+      .panel {
+        margin: 20px 0;
+        padding: 15px;
+        border: 1px solid #ccc;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>快点JS 控制面板</h1>
+
+    <!-- 脚本控制 -->
+    <div class="panel">
+      <h3>脚本控制</h3>
+      <p>脚本状态: <span id="task-status">检查中...</span></p>
+      <button class="button" onclick="startScript()">启动脚本</button>
+      <button class="button" onclick="stopScript()">停止脚本</button>
+      <button class="button" onclick="checkTaskStatus()">检查状态</button>
+    </div>
+
+    <!-- 快点 Agent 控制 -->
+    <div class="panel">
+      <h3>快点 Agent 控制</h3>
+      <p>状态: <span id="agent-status">检查中...</span></p>
+      <button class="button" onclick="startAgentService()">
+        启动 快点 Agent
+      </button>
+      <button class="button" onclick="checkAgentStatus()">检查状态</button>
+    </div>
+
+    <!-- 配置管理 -->
+    <div class="panel">
+      <h3>配置管理</h3>
+      <input type="text" id="config-key" placeholder="配置键" />
+      <input type="text" id="config-value" placeholder="配置值" />
+      <button class="button" onclick="setConfigItem()">设置配置</button>
+      <button class="button" onclick="getConfigItem()">获取配置</button>
+      <button class="button" onclick="showAllConfigs()">显示所有配置</button>
+    </div>
+
+    <!-- 对话框测试 -->
+    <div class="panel">
+      <h3>对话框测试</h3>
+      <button class="button" onclick="showToastMessage()">显示Toast</button>
+      <button class="button" onclick="showConfirmDialog()">
+        显示确认对话框
+      </button>
+      <button class="button" onclick="showInputDialog()">显示输入对话框</button>
+      <button class="button" onclick="showAlertDialog()">显示警告对话框</button>
+    </div>
+
+    <div id="log-container"></div>
+
+    <script>
+      // 脚本控制函数
+      function startScript() {
+        addLog("正在启动脚本...");
+        ms.startTask()
+          .then((result) => {
+            addLog(result ? "脚本启动成功" : "脚本启动失败");
+            checkTaskStatus();
+          })
+          .catch((error) => {
+            addLog("启动脚本出错: " + error);
+          });
+      }
+
+      function stopScript() {
+        addLog("正在停止脚本...");
+        ms.stopTask()
+          .then((result) => {
+            addLog(!result ? "脚本停止成功" : "脚本停止失败");
+            checkTaskStatus();
+          })
+          .catch((error) => {
+            addLog("停止脚本出错: " + error);
+          });
+      }
+
+      function checkTaskStatus() {
+        ms.isTaskRunning()
+          .then((isRunning) => {
+            const statusElement = document.getElementById("task-status");
+            statusElement.textContent = isRunning ? "运行中" : "已停止";
+            statusElement.className = isRunning
+              ? "status-online"
+              : "status-offline";
+            addLog("脚本状态: " + (isRunning ? "运行中" : "已停止"));
+          })
+          .catch((error) => {
+            addLog("获取脚本状态出错: " + error);
+          });
+      }
+
+      // 快点 Agent 控制函数
+      function startAgentService() {
+        addLog("正在启动 快点 Agent 服务...");
+        ms.startAgent()
+          .then((result) => {
+            if (result) {
+              addLog("快点 Agent 启动调用成功");
+              setTimeout(() => {
+                checkAgentStatus();
+              }, 2000);
+            } else {
+              addLog("快点 Agent 启动调用失败");
+            }
+          })
+          .catch((error) => {
+            addLog("启动 快点 Agent 服务出错: " + error);
+          });
+      }
+
+      function checkAgentStatus() {
+        ms.getAgentStatus()
+          .then((isRunning) => {
+            const statusElement = document.getElementById("agent-status");
+            statusElement.textContent = isRunning ? "已连接" : "未连接";
+            statusElement.className = isRunning
+              ? "status-online"
+              : "status-offline";
+            addLog("快点 Agent 状态: " + (isRunning ? "已连接" : "未连接"));
+          })
+          .catch((error) => {
+            addLog("获取 快点 Agent 状态出错: " + error);
+          });
+      }
+
+      // 配置管理函数
+      function setConfigItem() {
+        const key = document.getElementById("config-key").value;
+        const value = document.getElementById("config-value").value;
+        if (!key) {
+          alert("请输入配置键");
+          return;
+        }
+
+        ms.setConfig(key, value)
+          .then((success) => {
+            addLog(`设置配置 [${key}=${value}]: ${success ? "成功" : "失败"}`);
+          })
+          .catch((error) => {
+            addLog("设置配置出错: " + error);
+          });
+      }
+
+      function getConfigItem() {
+        const key = document.getElementById("config-key").value;
+        if (!key) {
+          alert("请输入配置键");
+          return;
+        }
+
+        ms.getConfig(key)
+          .then((value) => {
+            addLog(`获取配置 [${key}]: ${value}`);
+            document.getElementById("config-value").value = value || "";
+          })
+          .catch((error) => {
+            addLog("获取配置出错: " + error);
+          });
+      }
+
+      function showAllConfigs() {
+        ms.getAllConfig()
+          .then((configs) => {
+            addLog("所有配置: " + JSON.stringify(configs));
+          })
+          .catch((error) => {
+            addLog("获取所有配置出错: " + error);
+          });
+      }
+
+      // 对话框测试函数
+      function showToastMessage() {
+        // 注意：这里只是演示，实际上 showToast 是脚本端 API
+        // 网页端可以通过 emitEvent 通知脚本端显示 Toast
+        ms.emitEvent("show_toast", { message: "来自网页的 Toast" });
+        addLog("已发送显示 Toast 事件");
+      }
+
+      function showConfirmDialog() {
+        ms.emitEvent("show_confirm", {
+          title: "网页确认",
+          message: "来自网页的确认框",
+        });
+        addLog("已发送显示确认框事件");
+      }
+
+      function showInputDialog() {
+        ms.emitEvent("show_input", {
+          title: "网页输入",
+          message: "来自网页的输入框",
+        });
+        addLog("已发送显示输入框事件");
+      }
+
+      function showAlertDialog() {
+        ms.emitEvent("show_alert", {
+          title: "网页警告",
+          message: "来自网页的警告框",
+        });
+        addLog("已发送显示警告框事件");
+      }
+
+      // 辅助函数
+      function addLog(message) {
+        const container = document.getElementById("log-container");
+        const logEntry = document.createElement("div");
+        logEntry.textContent = `[${new Date().toLocaleTimeString()}] ${message}`;
+        container.appendChild(logEntry);
+        container.scrollTop = container.scrollHeight;
+      }
+
+      // 初始化
+      checkTaskStatus();
+      checkAgentStatus();
+    </script>
+  </body>
+</html>
+```