ArcGIS JS 4 applyEdits 删除要素时如何处理服务端返回的失败状态？

Question

在使用ArcGIS JS 4.x的`applyEdits`方法删除要素时，如果服务端返回失败状态（如权限不足、数据冲突或网络问题），如何优雅地捕获并处理这些错误？常见问题是：当调用`featureLayer.applyEdits(null, null, [objectId])`删除要素时，若部分或全部删除操作失败，返回的`rejects`对象中包含失败详情，但开发者可能未正确解析和反馈这些信息。这可能导致用户无法了解具体错误原因，影响用户体验。解决方法是通过Promise的回调函数检查`rejects`数组，遍历其中的错误信息，并根据错误代码（如`"error": 403`）或消息提示用户提供针对性的解决方案或提示信息。例如，可结合弹窗或日志记录详细展示失败原因，确保应用健壮性与用户友好性。

Answer 1

1. 问题概述

在使用ArcGIS JS API的applyEdits方法删除要素时，服务端可能因权限不足、数据冲突或网络问题返回失败状态。这种情况下，开发者需要捕获并处理这些错误以提升用户体验。然而，许多开发者未能正确解析和反馈rejects对象中的错误信息，导致用户无法了解具体原因。

2. 技术分析

• 错误来源：服务端返回的错误通常包含在Promise的rejects数组中。
• 常见问题：开发者可能忽略对rejects数组的检查，或者未根据具体的错误代码（如403）提供针对性提示。
• 解决方案：通过Promise的回调函数解析rejects数组，并根据错误类型动态生成提示信息。

3. 实现步骤

以下是优雅处理applyEdits删除操作错误的具体步骤：

1. 调用featureLayer.applyEdits(null, null, [objectId])。
2. 监听Promise的.then()和.catch()方法。
3. 在.then()中检查rejects数组。
4. 遍历rejects数组，提取错误代码和消息。
5. 根据错误类型显示提示信息或记录日志。

4. 示例代码

featureLayer.applyEdits(null, null, [objectId])
    .then((results) => {
        if (results.deleteRejected && results.deleteRejected.length > 0) {
            results.deleteRejected.forEach((error) => {
                const errorCode = error.error.code;
                const errorMessage = error.error.message;

                switch (errorCode) {
                    case 403:
                        alert("权限不足，请联系管理员获取权限！");
                        break;
                    case 409:
                        alert("数据冲突，请刷新页面后重试！");
                        break;
                    default:
                        console.error(`未知错误：${errorMessage}`);
                }
            });
        }
    })
    .catch((err) => {
        console.error("删除操作失败：", err);
    });

5. 流程图

以下流程图展示了从调用applyEdits到处理错误的整体逻辑：

sequenceDiagram
    participant Developer as 开发者
    participant ArcGIS_API as ArcGIS JS API
    participant Server as 服务端

    Developer->>ArcGIS_API: 调用 applyEdits 删除要素
    ArcGIS_API->>Server: 发送删除请求
    Server-->>ArcGIS_API: 返回成功或失败响应
    ArcGIS_API-->>Developer: 提供 results 对象
    Developer->>Developer: 检查 deleteRejected 数组
    Developer->>Developer: 根据错误代码处理

6. 错误处理最佳实践

错误代码	描述	推荐处理方式
403	权限不足	弹窗提示用户联系管理员
409	数据冲突	建议用户刷新页面后重试
500	服务器内部错误	记录日志并通知开发团队

通过以上方法，开发者可以确保应用在面对删除操作失败时具备更高的健壮性和用户友好性。