freeCodeCamp 每日编程挑战 300 实战用 JavaScript 手写嵌套 Schema 运行时校验器【免费下载链接】freeCodeCampfreeCodeCamp.orgs open-source codebase and curriculum. Learn math, programming, and computer science for free.项目地址: https://gitcode.com/GitHub_Trending/fr/freeCodeCamp本篇技术指南以 freeCodeCamp 仓库中 Challenge 300: Schema Validator Part 6 为蓝本讲解如何在无第三方库的前提下用纯 JavaScript 实现一个能校验「嵌套对象 联合类型 可选字段 字符串数组」结构的运行时数据校验函数。读完你将掌握typeof、Array.isArray、every、includes的组合校验模式理解 Union|、Optional?、Array[]三种模式标注语义并能独立解决同系列全部六道 Schema Validator 题目。挑战背景Schema Validator 六部曲的收官之题Schema Validator 是 freeCodeCamp 每日编程挑战Daily Coding ChallengesJavaScript 板块中的一组系列题编号为 Challenge 295 至 Challenge 300。六道题循序渐进地引入数据校验的各个维度关卡挑战引入的新概念Part 1Challenge 295单字段 string 校验必填字段、typeof、允许额外键Part 2Challenge 296三字段基础类型校验string/number/boolean三种基础类型Part 3Challenge 297引入 Roles 联合类型Union\|与枚举值白名单校验Part 4Challenge 298可选字段 supporterOptional?字段的「存在才校验」模式Part 5Challenge 299字符串数组 badgesArray[]与元素级类型校验Part 6Challenge 300嵌套结构 users 数组对象数组的递归校验与空数组语义本关Part 6是系列的收官题将前五关的全部校验技能整合进一个嵌套数据结构外层对象包裹一个UserProfile对象数组要求对数组中的每一个元素逐一执行完整校验。从 daily-coding-challenges-javascript.json 可以确认本块共编排了 365 道每日挑战Challenge 1 至 Challenge 365Schema Validator 系列位于第 295–300 位紧随其后的是 Challenge 301 Last Load。题目要求解读 UserProfile 嵌套 Schema题目给出一个用 JSON 风格书写的 Schema 定义JavaScript 对象 / Python 字典均适用Roles user | creator | moderator | staff | admin UserProfile { username: string, posts: number, verified: boolean, role: Roles, supporter?: boolean, badges: string[] } { users: UserProfile[] }题目同时给出四条标注语义的权威解释这是正确解题的关键|管道符表示或role字段必须是Roles列表中列出的五个值之一即user、creator、moderator、staff、admin?问号表示可选supporter后的问号意味着该字段可以不存在但只要存在就必须是boolean类型[]表示数组UserProfile[]表示由UserProfile对象组成的数组空数组是合法的users: []应返回true允许额外键对象中多出的字段如测试用例中的followers: 20不影响校验结果无需报错。值得注意的是supporter?: boolean的可选语义并不等同于 允许null。测试用例中supporter: false字符串依然会被判为非法因为可选字段的约束是要么缺失、要么类型正确。十组测试用例逐条剖析真值表题目的--hints--节给出了 10 组断言assert.isTrue/assert.isFalse它们全面覆盖了合法输入、边界输入与各类非法输入#输入特征预期违反的规则1两个合法用户其一含supporter: true、额外键followers: 20true全部满足额外键被允许2{ users: [] }true空数组合法3users是单个对象而非数组falseusers必须是数组4badges: [liked, 6]混入数字falsebadges元素必须是 string5supporter: false字符串false可选字段存在时必须是 boolean6role: superstar不在白名单falserole必须是五个枚举值之一7verified: yes字符串falseverified必须是 boolean8posts: 10字符串falseposts必须是 number9缺少username字段false必填字段缺失10数组第三个元素是空对象{}false每个用户都必须满足全部必填约束这组用例的设计思路非常典型先验证合法样本与边界样本空数组、额外键再用每种类型各构造一个错误样本的方式穷举非法路径。第 5–8 号用例分别对应supporter、role、verified、posts四种字段的类型/枚举错误第 9–10 号用例则聚焦必填字段的缺失问题。起始代码与解题思路题目提供的起始代码如下function isValidSchema(obj) { return obj; }起始代码只是一个占位实现直接返回原对象显然无法通过任何断言。解题的关键在于把校验拆成两层外层校验obj.users必须是一个数组Array.isArray因为users: {...}单个对象或users缺失都属于非法内层校验对数组中每个元素执行isValidUser全字段校验这本质上就是 Part 5 中isValidSchema的逻辑被抽取成了可复用的子函数。由于外层要求每一个用户都合法数组上现成的every方法是天然的语义对应——every在空数组上恒返回true恰好契合空数组合法的规则无需额外写空数组特判。官方解法逐行拆解题目的--solutions--节给出了完整参考实现function isValidSchema(obj) { const roles [user, creator, moderator, staff, admin]; function isValidUser(user) { return ( typeof user.username string typeof user.posts number typeof user.verified boolean roles.includes(user.role) (user.supporter undefined || typeof user.supporter boolean) Array.isArray(user.badges) user.badges.every(b typeof b string) ); } return Array.isArray(obj.users) obj.users.every(isValidUser); }字段校验的实现细节1. 必填基础字段typeof三连username、posts、verified三个必填字段分别用typeof检查string、number、boolean。这里利用了 JS 的一个关键特性访问不存在的属性返回undefined而typeof undefined不等于任何目标类型因此typeof检查天然覆盖了字段缺失的情况——这正是第 9、10 号用例被判定为false的原因user.username为undefined。2. 枚举字段白名单 includesrole不做类型推导而是用roles.includes(user.role)做白名单比对。includes使用严格相等因此superstar、true、数字等任何非白名单值都会被拒绝。用数组代替switch/多重if的好处是声明式、易扩展后续想增加角色只需在roles数组中追加一项。3. 可选字段undefined短路supporter的校验是这道题最精妙的表达式(user.supporter undefined || typeof user.supporter boolean)它实现了缺省放行、存在则验型的双态逻辑字段缺失时undefined直接通过短路返回true字段存在时继续校验其类型。注意它刻意没有检查null——typeof null object所以supporter: null会被判定为非法这与 Schema 语义指定类型则必须是 boolean一致。4. 数组字段双层校验badges需要两步先Array.isArray(user.badges)确认它是数组再user.badges.every(b typeof b string)确认每个元素都是字符串。第 4 号用例中badges: [liked, 6]正是被every捕获——数字 6 不满足字符串检查。空数组同样因every的恒真性而通过与badges 可为空的规则吻合。5. 嵌套结构every的组合复用外层Array.isArray(obj.users) obj.users.every(isValidUser)把整道题压缩成一行。users不是数组第 3 号用例、数组中存在任一非法用户第 10 号用例的空对象{}都会让整体返回false。将isValidUser定义为嵌套函数并只负责单个对象体现了单一职责的分解思想也让系列前五关积累的校验逻辑得以直接复用。校验技巧纵深为什么用这些 API从实现层面看本解法的每个 API 选择都有明确理由值得归纳为可迁移的校验模式模式代码形态适用场景反例陷阱基础类型检查typeof x string必填标量字段typeof null object无法区分null与对象枚举白名单arr.includes(x)有限取值集合误用做宽松比较会放过10与10可选字段x undefined \|\| 校验(x)可选但存在即须验型遗漏undefined判断会把合法缺省判为非法数组容器Array.isArray(x)区分数组与普通对象typeof [] object不能用typeof判断数组元素批量校验arr.every(pred)全元素满足某条件some语义相反会放过混入的非法元素缺失字段检测依赖typeof undefined的失败特性必填字段使用if (x)会把0、、false误判为缺失值得注意的是typeof user.posts number会放过NaN、Infinity等特殊数值typeof user.username string也会放过空字符串Part 1 的测试用例明确要求username: 应返回true。这说明本系列 Schema 校验的粒度是类型级而非值域级——如果你要校验业务数据的值域约束如帖子数必须大于 0需要在typeof之外再叠加范围判断。用 Python 实现同款 Schema题目描述明确指出该 Schema 同时适用于 JavaScript 对象与 Python 字典以下是与官方解法等价的 Python 参考实现daily-coding-challenges-python块的题目使用dict表述ROLES {user, creator, moderator, staff, admin} def is_valid_schema(obj): def is_valid_user(user): return ( isinstance(user.get(username), str) and isinstance(user.get(posts), (int, float)) and not isinstance(user.get(posts), bool) and isinstance(user.get(verified), bool) and user.get(role) in ROLES and (supporter not in user or isinstance(user[supporter], bool)) and isinstance(user.get(badges), list) and all(isinstance(b, str) for b in user[badges]) ) return isinstance(obj.get(users), list) and all(is_valid_user(u) for u in obj[users])Python 版有两个值得注意的差异一是dict.get()天然返回None可配合in判断实现可选字段二是bool是int的子类若用isinstance(x, int)校验数字字段会放过True/False因此需要显式排除。这与 JavaScript 中typeof true boolean的严格区分形成了对照。在仓库中运行与验证从题目到线上挑战文件结构本关是challengeType: 28的每日编程挑战其 Markdown 文件遵循 freeCodeCamp 标准挑战格式frontmatterid / title / challengeType / dashedName→--description--题目描述→--hints--测试断言→--seed--起始代码→--solutions--参考解法。Chai 的assert.isTrue/assert.isFalse断言会被自由代码营的测试执行器逐一运行作为判题依据。每日挑战的发布链路从仓库源码可以还原出本关从题目文件到每日上线的完整链路题目编写挑战以 Markdown 形式维护在 curriculum/challenges/english/blocks/daily-coding-challenges-javascript 目录下块的元数据与挑战顺序登记在 daily-coding-challenges-javascript.json种子数据生成tools/daily-challenges/seed-daily-challenges.ts 脚本通过 GraphQL 从客户端获取全部 365 道挑战校验 JavaScript 与 Python 数量一致后按固定起始日期2025-08-11源码中通过硬编码断言防止发布后误改每天推进一天写入 MongoDB 的DailyCodingChallenges集合每日对外提供api/src/daily-coding-challenge/routes/daily-coding-challenge.ts 中的GET /daily-coding-challenge/date/:date路由按日期从数据库查询当天挑战且不会返回晚于美中时区当天日期的挑战实现每日一题的节奏控制提交与判分用户完成挑战后通过主挑战提交路由上报响应 Schema 定义于 api/src/schemas/challenge/daily-coding-challenge-completed.ts其中language字段限定为javascript | python二选一与本系列同一 Schema 双语言实现的设计一脉相承。本地调试建议若想在本地亲手验证解法无需搭起完整环境仅用 Node.js 即可把官方解法与 10 组断言粘贴进一个脚本用console.assert或直接比较返回值逐条核对。例如最易踩坑的两个用例console.log(isValidSchema({ users: [] })); // true空数组合法 console.log(isValidSchema({ users: {} })); // falseusers 必须是数组总结Challenge 300 作为 Schema Validator 系列的收官题把六道题积累的知识点——typeof基础类型校验、白名单枚举、可选字段短路、数组容器与元素级校验——全部整合进嵌套对象数组的校验中。其官方解法的核心价值在于两点用Array.isArrayevery把对象数组的递归校验压缩成声明式的两层管道以及用undefined短路精确表达可选字段存在才验型的 Schema 语义。这套模式在真实工程中同样常见无论是校验 API 请求体、解析配置文件还是验证外部数据源的结构手写轻量校验器都是零依赖环境下最直接的方案。若想继续深入可依次攻克同系列 Part 1–5 逐步建立能力或研读仓库中 daily-coding-challenge-validator.ts 等客户端校验实现观察生产代码如何处理同样的数据结构问题。【免费下载链接】freeCodeCampfreeCodeCamp.orgs open-source codebase and curriculum. Learn math, programming, and computer science for free.项目地址: https://gitcode.com/GitHub_Trending/fr/freeCodeCamp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/10 16:57:20 · 阅读 1.2k freeCodeCamp 每日编程挑战 300 实战：用 JavaScript 手写嵌套 Schema 运行时校验器
freeCodeCamp 每日编程挑战 300 实战用 JavaScript 手写嵌套 Schema 运行时校验器【免费下载链接】freeCodeCampfreeCodeCamp.orgs open-source codebase and curriculum. Learn math, programming, and computer science for free.项目地址: https://gitcode.com/GitHub_Trending/fr/freeCodeCamp本篇技术指南以 freeCodeCamp 仓库中 Challenge 300: Schema Validator Part 6 为蓝本讲解如何在无第三方库的前提下用纯 JavaScript 实现一个能校验「嵌套对象 联合类型 可选字段 字符串数组」结构的运行时数据校验函数。读完你将掌握typeof、Array.isArray、every、includes的组合校验模式理解 Union|、Optional?、Array[]三种模式标注语义并能独立解决同系列全部六道 Schema Validator 题目。挑战背景Schema Validator 六部曲的收官之题Schema Validator 是 freeCodeCamp 每日编程挑战Daily Coding ChallengesJavaScript 板块中的一组系列题编号为 Challenge 295 至 Challenge 300。六道题循序渐进地引入数据校验的各个维度关卡挑战引入的新概念Part 1Challenge 295单字段 string 校验必填字段、typeof、允许额外键Part 2Challenge 296三字段基础类型校验string/number/boolean三种基础类型Part 3Challenge 297引入 Roles 联合类型Union\|与枚举值白名单校验Part 4Challenge 298可选字段 supporterOptional?字段的「存在才校验」模式Part 5Challenge 299字符串数组 badgesArray[]与元素级类型校验Part 6Challenge 300嵌套结构 users 数组对象数组的递归校验与空数组语义本关Part 6是系列的收官题将前五关的全部校验技能整合进一个嵌套数据结构外层对象包裹一个UserProfile对象数组要求对数组中的每一个元素逐一执行完整校验。从 daily-coding-challenges-javascript.json 可以确认本块共编排了 365 道每日挑战Challenge 1 至 Challenge 365Schema Validator 系列位于第 295–300 位紧随其后的是 Challenge 301 Last Load。题目要求解读 UserProfile 嵌套 Schema题目给出一个用 JSON 风格书写的 Schema 定义JavaScript 对象 / Python 字典均适用Roles user | creator | moderator | staff | admin UserProfile { username: string, posts: number, verified: boolean, role: Roles, supporter?: boolean, badges: string[] } { users: UserProfile[] }题目同时给出四条标注语义的权威解释这是正确解题的关键|管道符表示或role字段必须是Roles列表中列出的五个值之一即user、creator、moderator、staff、admin?问号表示可选supporter后的问号意味着该字段可以不存在但只要存在就必须是boolean类型[]表示数组UserProfile[]表示由UserProfile对象组成的数组空数组是合法的users: []应返回true允许额外键对象中多出的字段如测试用例中的followers: 20不影响校验结果无需报错。值得注意的是supporter?: boolean的可选语义并不等同于 允许null。测试用例中supporter: false字符串依然会被判为非法因为可选字段的约束是要么缺失、要么类型正确。十组测试用例逐条剖析真值表题目的--hints--节给出了 10 组断言assert.isTrue/assert.isFalse它们全面覆盖了合法输入、边界输入与各类非法输入#输入特征预期违反的规则1两个合法用户其一含supporter: true、额外键followers: 20true全部满足额外键被允许2{ users: [] }true空数组合法3users是单个对象而非数组falseusers必须是数组4badges: [liked, 6]混入数字falsebadges元素必须是 string5supporter: false字符串false可选字段存在时必须是 boolean6role: superstar不在白名单falserole必须是五个枚举值之一7verified: yes字符串falseverified必须是 boolean8posts: 10字符串falseposts必须是 number9缺少username字段false必填字段缺失10数组第三个元素是空对象{}false每个用户都必须满足全部必填约束这组用例的设计思路非常典型先验证合法样本与边界样本空数组、额外键再用每种类型各构造一个错误样本的方式穷举非法路径。第 5–8 号用例分别对应supporter、role、verified、posts四种字段的类型/枚举错误第 9–10 号用例则聚焦必填字段的缺失问题。起始代码与解题思路题目提供的起始代码如下function isValidSchema(obj) { return obj; }起始代码只是一个占位实现直接返回原对象显然无法通过任何断言。解题的关键在于把校验拆成两层外层校验obj.users必须是一个数组Array.isArray因为users: {...}单个对象或users缺失都属于非法内层校验对数组中每个元素执行isValidUser全字段校验这本质上就是 Part 5 中isValidSchema的逻辑被抽取成了可复用的子函数。由于外层要求每一个用户都合法数组上现成的every方法是天然的语义对应——every在空数组上恒返回true恰好契合空数组合法的规则无需额外写空数组特判。官方解法逐行拆解题目的--solutions--节给出了完整参考实现function isValidSchema(obj) { const roles [user, creator, moderator, staff, admin]; function isValidUser(user) { return ( typeof user.username string typeof user.posts number typeof user.verified boolean roles.includes(user.role) (user.supporter undefined || typeof user.supporter boolean) Array.isArray(user.badges) user.badges.every(b typeof b string) ); } return Array.isArray(obj.users) obj.users.every(isValidUser); }字段校验的实现细节1. 必填基础字段typeof三连username、posts、verified三个必填字段分别用typeof检查string、number、boolean。这里利用了 JS 的一个关键特性访问不存在的属性返回undefined而typeof undefined不等于任何目标类型因此typeof检查天然覆盖了字段缺失的情况——这正是第 9、10 号用例被判定为false的原因user.username为undefined。2. 枚举字段白名单 includesrole不做类型推导而是用roles.includes(user.role)做白名单比对。includes使用严格相等因此superstar、true、数字等任何非白名单值都会被拒绝。用数组代替switch/多重if的好处是声明式、易扩展后续想增加角色只需在roles数组中追加一项。3. 可选字段undefined短路supporter的校验是这道题最精妙的表达式(user.supporter undefined || typeof user.supporter boolean)它实现了缺省放行、存在则验型的双态逻辑字段缺失时undefined直接通过短路返回true字段存在时继续校验其类型。注意它刻意没有检查null——typeof null object所以supporter: null会被判定为非法这与 Schema 语义指定类型则必须是 boolean一致。4. 数组字段双层校验badges需要两步先Array.isArray(user.badges)确认它是数组再user.badges.every(b typeof b string)确认每个元素都是字符串。第 4 号用例中badges: [liked, 6]正是被every捕获——数字 6 不满足字符串检查。空数组同样因every的恒真性而通过与badges 可为空的规则吻合。5. 嵌套结构every的组合复用外层Array.isArray(obj.users) obj.users.every(isValidUser)把整道题压缩成一行。users不是数组第 3 号用例、数组中存在任一非法用户第 10 号用例的空对象{}都会让整体返回false。将isValidUser定义为嵌套函数并只负责单个对象体现了单一职责的分解思想也让系列前五关积累的校验逻辑得以直接复用。校验技巧纵深为什么用这些 API从实现层面看本解法的每个 API 选择都有明确理由值得归纳为可迁移的校验模式模式代码形态适用场景反例陷阱基础类型检查typeof x string必填标量字段typeof null object无法区分null与对象枚举白名单arr.includes(x)有限取值集合误用做宽松比较会放过10与10可选字段x undefined \|\| 校验(x)可选但存在即须验型遗漏undefined判断会把合法缺省判为非法数组容器Array.isArray(x)区分数组与普通对象typeof [] object不能用typeof判断数组元素批量校验arr.every(pred)全元素满足某条件some语义相反会放过混入的非法元素缺失字段检测依赖typeof undefined的失败特性必填字段使用if (x)会把0、、false误判为缺失值得注意的是typeof user.posts number会放过NaN、Infinity等特殊数值typeof user.username string也会放过空字符串Part 1 的测试用例明确要求username: 应返回true。这说明本系列 Schema 校验的粒度是类型级而非值域级——如果你要校验业务数据的值域约束如帖子数必须大于 0需要在typeof之外再叠加范围判断。用 Python 实现同款 Schema题目描述明确指出该 Schema 同时适用于 JavaScript 对象与 Python 字典以下是与官方解法等价的 Python 参考实现daily-coding-challenges-python块的题目使用dict表述ROLES {user, creator, moderator, staff, admin} def is_valid_schema(obj): def is_valid_user(user): return ( isinstance(user.get(username), str) and isinstance(user.get(posts), (int, float)) and not isinstance(user.get(posts), bool) and isinstance(user.get(verified), bool) and user.get(role) in ROLES and (supporter not in user or isinstance(user[supporter], bool)) and isinstance(user.get(badges), list) and all(isinstance(b, str) for b in user[badges]) ) return isinstance(obj.get(users), list) and all(is_valid_user(u) for u in obj[users])Python 版有两个值得注意的差异一是dict.get()天然返回None可配合in判断实现可选字段二是bool是int的子类若用isinstance(x, int)校验数字字段会放过True/False因此需要显式排除。这与 JavaScript 中typeof true boolean的严格区分形成了对照。在仓库中运行与验证从题目到线上挑战文件结构本关是challengeType: 28的每日编程挑战其 Markdown 文件遵循 freeCodeCamp 标准挑战格式frontmatterid / title / challengeType / dashedName→--description--题目描述→--hints--测试断言→--seed--起始代码→--solutions--参考解法。Chai 的assert.isTrue/assert.isFalse断言会被自由代码营的测试执行器逐一运行作为判题依据。每日挑战的发布链路从仓库源码可以还原出本关从题目文件到每日上线的完整链路题目编写挑战以 Markdown 形式维护在 curriculum/challenges/english/blocks/daily-coding-challenges-javascript 目录下块的元数据与挑战顺序登记在 daily-coding-challenges-javascript.json种子数据生成tools/daily-challenges/seed-daily-challenges.ts 脚本通过 GraphQL 从客户端获取全部 365 道挑战校验 JavaScript 与 Python 数量一致后按固定起始日期2025-08-11源码中通过硬编码断言防止发布后误改每天推进一天写入 MongoDB 的DailyCodingChallenges集合每日对外提供api/src/daily-coding-challenge/routes/daily-coding-challenge.ts 中的GET /daily-coding-challenge/date/:date路由按日期从数据库查询当天挑战且不会返回晚于美中时区当天日期的挑战实现每日一题的节奏控制提交与判分用户完成挑战后通过主挑战提交路由上报响应 Schema 定义于 api/src/schemas/challenge/daily-coding-challenge-completed.ts其中language字段限定为javascript | python二选一与本系列同一 Schema 双语言实现的设计一脉相承。本地调试建议若想在本地亲手验证解法无需搭起完整环境仅用 Node.js 即可把官方解法与 10 组断言粘贴进一个脚本用console.assert或直接比较返回值逐条核对。例如最易踩坑的两个用例console.log(isValidSchema({ users: [] })); // true空数组合法 console.log(isValidSchema({ users: {} })); // falseusers 必须是数组总结Challenge 300 作为 Schema Validator 系列的收官题把六道题积累的知识点——typeof基础类型校验、白名单枚举、可选字段短路、数组容器与元素级校验——全部整合进嵌套对象数组的校验中。其官方解法的核心价值在于两点用Array.isArrayevery把对象数组的递归校验压缩成声明式的两层管道以及用undefined短路精确表达可选字段存在才验型的 Schema 语义。这套模式在真实工程中同样常见无论是校验 API 请求体、解析配置文件还是验证外部数据源的结构手写轻量校验器都是零依赖环境下最直接的方案。若想继续深入可依次攻克同系列 Part 1–5 逐步建立能力或研读仓库中 daily-coding-challenge-validator.ts 等客户端校验实现观察生产代码如何处理同样的数据结构问题。【免费下载链接】freeCodeCampfreeCodeCamp.orgs open-source codebase and curriculum. Learn math, programming, and computer science for free.项目地址: https://gitcode.com/GitHub_Trending/fr/freeCodeCamp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考