JavaScript中函数、变量、类等元素是否有统一的通用称谓?
JavaScript可定义元素通用称谓与public interface表述规范
可定义元素的通用称谓
JavaScript生态中对function、variable、class、module这类可定义元素,根据使用场景有两类通用称谓:
- 如果是指代库对外暴露的所有可访问内容,业内最常用的是 导出项 或者 API成员,前者贴合JS模块系统的
export特性,后者是跨语言的通用表述,都可以覆盖函数、类、实例成员、常量、命名空间等所有对外暴露的内容 - 如果是包含内部未暴露的所有可定义语言元素,统一称为 语法实体 即可,不过这个表述一般只在语言规范相关场景使用,库文档场景基本不会用到
public interface表述的规范性
「编写库的public interface文档」这个表述是完全规范正确的,属于前端乃至整个软件行业的通用惯例:
public interface(公开接口)的定义天然包含了库对外暴露的所有可供开发者调用、访问的内容,没有类型限制,不管是函数、类、常量还是命名空间,只要是对外公开的都属于公开接口的范畴
包括React、Vue、Lodash等主流JS库的官方文档、ECMAScript规范文档里都大量使用这个表述,你完全可以放心使用。
内容的提问来源于stack exchange,提问作者Jackezo Opiklam
相关产品推荐
相关产品推荐

