[聚合文章] Swagger UI 3.9.0 发布,API 在线文档生成利器

软件架构 2018-01-07 22 阅读

Swagger UI 3.9.0 已发布,这是一款 API 在线文档生成和调试工具。

该版本包含核心插件 API 更改,以及一些突破性变化,包括:

  • Introduced a breaking function signature change to errActions.newThrownErr action creator (from  (err, action) to  (err) ) and  err_new_thrown_err action payload (stopped nesting error content under  error key in payload, now the error  is the payload).

  • 特性:added error catcher for statePlugin interfaces; prevents errors in plugin code from crashing entire application instance (via #4067 )

    • The only downside to this is that some errors are now a bit harder to trace! Set a breakpoint at console.error and walk down the stack to see what's going wrong.

  • 特性:display error content when definition/config load fails (via #4069 )

  • 特性:display parameter enums, defaults, and examples when not in Try-It-Out mode (via #3977 )

  • 改进:added hasOwnProperty checks to a handful of  for...in loops (via  #4043 )

  • 改进:now using nginx location to set Docker base url instead of moving things around the filesystem (via  #4073 )

  • 改进:brought parameter model property description styling in line with styling for.... everything else (via #4075 )

  • 修复:check for Promise on global/window object, which makes IE11 a very happy browser (via  #4077 )

  • Housekeeping: used zopflipng to compress PNG assets in repo (via  #4037 )

  • Housekeeping: added maintainer documentation for PR merging workflow (via #4076 )

下载地址:

注:本文内容来自互联网,旨在为开发者提供分享、交流的平台。如有涉及文章版权等事宜,请你联系站长进行处理。