场景概述与问题分析
在web开发中，我们经常需要将后端生成的一些结构化数据传递到前端，以便用户交互或进一步处理。一个常见场景是在数据表格中，每个行对应一个实体对象，我们可能希望通过一个单选按钮（radio button）来选中整行数据。例如，当用户选择某一行时，我们需要获取该行的所有列数据。
最初的设想是直接将一个代表行数据的JavaScript对象（或后端对应的字典）赋值给HTML元素的value属性。考虑以下Jinja模板代码片段，它尝试将一个包含文件信息的字典table_data赋值给一个单选按钮的value属性：
{% set table_data = {
'fileName': file_name,
'fileType': file_type,
'size': size,
'createdBy': create_by,
'lastModifiedDate': last_modified_date
} %}
当这个页面渲染到浏览器并被用户选中时，我们通过JavaScript获取该单选按钮的value：
let obj = e.target.value; console.log(obj);
此时，控制台输出通常会是一个看起来像JavaScript对象的字符串，例如： "{'fileName': 'This is the file2.png','fileType': 'file','size': '4.5 MB','createdBy': 'Anuj','lastModifiedDate': '23 Apr 2022, 06:00 PM'}"
然而，当我们尝试直接访问其属性时，如obj.fileName，控制台会返回undefined。这是因为尽管其内容看起来像一个对象，但对于JavaScript而言，它仍然是一个纯粹的字符串。HTML属性的value字段只能存储字符串，任何复杂的数据类型在被赋给它时都会被隐式转换为字符串。
解决方案：使用 JSON.parse() 解析字符串
要解决这个问题，我们需要将这个字符串化的对象转换回一个真正的JavaScript对象。JavaScript提供了一个内置函数JSON.parse()，专门用于解析符合JSON格式的字符串，并将其转换为对应的JavaScript值或对象。
立即学习“前端免费学习笔记（深入）”；
核心解决方案代码如下：
// 假设 e.target.value 是从HTML元素获取到的字符串
let stringifiedObject = e.target.value;
try {
// 使用 JSON.parse() 将字符串解析为JavaScript对象
let obj = JSON.parse(stringifiedObject);
console.log(obj); // 现在这是一个真正的JavaScript对象
console.log(obj.fileName); // 可以正常访问属性
console.log(obj.fileType);
// ...以此类推，访问其他属性
} catch (error) {
console.error("解析JSON字符串失败:", error);
console.error("原始字符串:", stringifiedObject);
// 处理解析错误，例如字符串格式不正确
}通过JSON.parse()处理后，obj变量将不再是字符串，而是一个可以正常访问其属性的JavaScript对象。
关键注意事项：确保JSON格式的有效性
JSON.parse()函数要求输入的字符串必须是严格有效的JSON格式。这意味着：
- 键和字符串值必须使用双引号：例如，{"key": "value"}是有效的，而{'key': 'value'}或{key: "value"}则不是。
- 不能包含注释。
- 不能有尾随逗号。
回顾我们最初的Jinja模板和控制台输出，字符串中使用了单引号（{'fileName': ...}）。这在Python字典的默认字符串表示中很常见，但不是有效的JSON。因此，直接将{{ table_data }}输出到HTML会导致JSON.parse()失败。
为了确保Jinja模板输出的字符串符合JSON规范，我们应该使用Jinja内置的tojson过滤器。这个过滤器会将Python字典或列表安全地转换为一个符合JSON格式的字符串，并进行必要的HTML实体编码，以避免潜在的XSS攻击。
修正后的Jinja模板代码：
{% set table_data = {
'fileName': file_name,
'fileType': file_type,
'size': size,
'createdBy': create_by,
'lastModifiedDate': last_modified_date
} %}
使用| tojson过滤器后，value属性将包含一个严格符合JSON规范的字符串，例如： {"fileName": "This is the file2.png","fileType": "file","size": "4.5 MB","createdBy": "Anuj","lastModifiedDate": "23 Apr 2022, 06:00 PM"} 这样，前端的JSON.parse()就能顺利解析它。
总结
当需要将复杂的结构化数据从后端传递到前端HTML元素的value属性时，务必记住HTML属性只能存储字符串。为了在前端将其恢复为可操作的JavaScript对象，核心步骤是：
- 后端/模板层： 使用合适的序列化工具（如Jinja的tojson过滤器）将数据转换为严格符合JSON格式的字符串。
- 前端JavaScript： 使用JSON.parse()函数将获取到的字符串解析为JavaScript对象。同时，建议使用try...catch块来处理可能的解析错误，提高代码的健壮性。
遵循这些步骤，可以有效地在前后端之间传递和处理复杂的数据结构，实现更丰富和交互性更强的Web应用。
