AMD 规范

news/2024/11/29 7:57:56/

异步模块定义规范(AMD)制定了定义模块的规则,这样模块和模块的依赖可以被异步加载。这和浏览器的异步加载模块的环境刚好适应(浏览器同步加载模块会导致性能、可用性、调试和跨域访问等问题)。

此AMD与科技公司AMD 及其制造的AMD处理器无关。

  • 测试
  • 讨论

API说明

define() 函数

本规范只定义了一个函数 "define",它是全局变量。函数的描述为:

    define(id?, dependencies?, factory);

id

名字

第一个参数,id,是个字符串。它指的是定义中模块的名字,这个参数是可选的。如果没有提供该参数,模块的名字应该默认为模块加载器请求的指定脚本的名字。如果提供了该参数,模块名必须是“顶级”的和绝对的(不允许相对名字)。

模块名的格式

模块名用来唯一标识定义中模块,它们同样在依赖数组中使用。AMD的模块名规范是CommonJS模块名规范的超集。引用如下:

  • 模块名是由一个或多个单词以正斜杠为分隔符拼接成的字符串
  • 单词须为驼峰形式,或者".",".."
  • 模块名不允许文件扩展名的形式,如".js"
  • 模块名可以为 "相对的" 或 "顶级的"。如果首字符为"."或".."则为"相对的"模块名
  • 顶级的模块名从根命名空间的概念模块解析
  • 相对的模块名从 "require" 书写和调用的模块解析

上文引用的CommonJS模块id属性常被用于JavaScript模块。

相对模块名解析示例:

  • 如果模块 "a/b/c" 请求 "../d", 则解析为"a/d"
  • 如果模块 "a/b/c" 请求 "./e", 则解析为"a/b/e"

如果AMD的实现支持加载器插件(Loader-Plugins),则"!"符号用于分隔加载器插件模块名和插件资源名。由于插件资源名可以非常自由地命名,大多数字符都允许在插件资源名使用。

(译注:关于Loader-Plugins)

依赖

第二个参数,dependencies,是个定义中模块所依赖模块的数组。依赖模块必须根据模块的工厂方法优先级执行,并且执行的结果应该按照依赖数组中的位置顺序以参数的形式传入(定义中模块的)工厂方法中。

依赖的模块名如果是相对的,应该解析为相对定义中的模块。换句话来说,相对名解析为相对于模块的名字,并非相对于寻找该模块的名字的路径。

本规范定义了三种特殊的依赖关键字。如果"require","exports", 或 "module"出现在依赖列表中,参数应该按照CommonJS模块规范自由变量去解析。

依赖参数是可选的,如果忽略此参数,它应该默认为["require", "exports", "module"]。然而,如果工厂方法的形参个数小于3,加载器会选择以函数指定的参数个数调用工厂方法。

工厂方法

第三个参数,factory,为模块初始化要执行的函数或对象。如果为函数,它应该只被执行一次。如果是对象,此对象应该为模块的输出值。

如果工厂方法返回一个值(对象,函数,或任意强制类型转换为true的值),应该为设置为模块的输出值。

简单的 CommonJS 转换

如果依赖性参数被忽略,模块加载器可以选择扫描工厂方法中的require语句以获得依赖性(字面量形为require("module-id"))。第一个参数必须字面量为require从而使此机制正常工作。

在某些情况下,因为脚本大小的限制或函数不支持toString方法(Opera Mobile是已知的不支持函数的toString方法),模块加载器可以选择扫描不扫描依赖性。

如果有依赖参数,模块加载器不应该在工厂方法中扫描依赖性。

define.amd 属性

为了清晰的标识全局函数(为浏览器加载script必须的)遵从AMD编程接口,任何全局函数应该有一个"amd"的属性,它的值为一个对象。这样可以防止与现有的定义了define函数但不遵从AMD编程接口的代码相冲突。

当前,define.amd对象的属性没有包含在本规范中。实现本规范的作者,可以用它通知超出本规范编程接口基本实现的额外能力。

define.amd的存在表明函数遵循本规范。如果有另外一个版本的编程接口,那么应该定义另外一个属性,如define.amd2,表明实现只遵循该版本的编程接口。

一个如何定义同一个环境中允许多次加载同一个版本的模块的实现:

    define.amd = {multiversion: true};

最简短的定义:

    define.amd = {};

一次输出多个模块

在一个脚本中可以使用多次define调用。这些define调用的顺序不应该是重要的。早一些的模块定义中所指定的依赖,可以在同一脚本中晚一些定义。模块加载器负责延迟加载未解决的依赖,直到全部脚本加载完毕,防止没必要的请求。

例子

使用 require 和 exports

创建一个名为"alpha"的模块,使用了require,exports,和名为"beta"的模块:

   define("alpha", ["require", "exports", "beta"], function (require, exports, beta) {exports.verb = function() {return beta.verb();//Or:return require("beta").verb();}});

一个返回对象的匿名模块:

   define(["alpha"], function (alpha) {return {verb: function(){return alpha.verb() + 2;}};});

一个没有依赖性的模块可以直接定义对象:

   define({add: function(x, y){return x + y;}});

一个使用了简单CommonJS转换的模块定义:

   define(function (require, exports, module) {var a = require('a'),b = require('b');exports.action = function () {};});

全局变量

本规范保留全局变量"define"以用来实现本规范。包额外信息异步定义编程接口是为将来的CommonJS API保留的。模块加载器不应在此函数添加额外的方法或属性。

本规范保留全局变量"require"被模块加载器使用。模块加载器可以在合适的情况下自由地使用该全局变量。它可以使用这个变量或添加任何属性以完成模块加载器的特定功能。它同样也可以选择完全不使用"require"。

使用注意

为了使静态分析工具(如build工具)可以正常工作,推荐使用字面上形如的'define(...)'。

与CommonJS的关系

一个关于本API的wiki开始在CommonJS wiki中创建了,作为中转的格式,模块中转。但是为了包含模块定义接口,随着时间而不断改变。在CommonJS列表中关于推荐本API作为模块定义API尚未达成一致。本API被转移到它自己的wiki和讨论组中。

AMD可以作为CommonJS模块一个中转的版本只要CommonJS没有被用来同步的require调用。使用同步require调用的CommonJS代码可以被转换为使用回调风格的AMD模块加载器。


http://www.ppmy.cn/news/749335.html

相关文章

AMD GPU内存管理(2):GEM/TTM

参考内核代码:Linux-6.1/driver/gpu/drm/amd 一、背景 在AMD的Linux GPU驱动中,只有计算相关的业务(amdkfd)直接使用TTM来allocate/free内存,当然在dma-buf来进行进程间通信内存共享时也用到了GEM。而在图形相关业务中既使用了GEM也使用了TTM。下面对GEM和TTM的核心结构和函…

JavaScript AMD 模块

JavaScript AMD (Asynchronous Module Definition) 是一种 JavaScript 模块化编程的规范,它允许您异步加载模块并且在加载完成后执行模块的代码。这种方式的优势在于可以按需加载模块,并且可以在加载模块时并行执行其他任务,从而提升应用的性…

AMD模块写法

AMD模块的写法 require.js加载的模块,采用AMD规范。也就是说,模块必须按照AMD的规定来写。 具体来说,就是模块必须采用特定的define()函数来定义。如果一个模块不依赖其他模块,那么可以直接定义在define()函数之中。 假定现在有一…

amd模块化

一、amd定义及规范说明 AMD(Asynchronous Module Definition):异步模块加载机制,是一个在浏览器端模块化开发的规范。什么是异步模块加载机制:JavaScript在浏览器中被解析和执行时具有阻塞的特性,当JavaScript代码执行时&#xf…

区分计算机和服务器的内存条,AMD专用内存是什么意思 AMD专用内存和普通内存条的区别及真相...

相信一些用户在网上在购买内存的时候找到一些低价位的内存,看描述上写有“AMD专用内存”,AMD专用内存是什么意思?那么对于这种称为AMD专用内存的不难理解,肯定intel平台是使用不了的,而只有AMD平台能够使用,今天装机之家来给大家说说AMD专用内存和普通内存条的区别及真相…

amd支持服务器内存,amd专用内存和普通的内存有什么区别?

相信大家都知道内存对于电脑来说是一个非常重要的作用,不知道大家有没有听说过amd专用内存条?对这方面不太熟悉的朋友不妨进来看看,为了防止以后给一些不良的商家欺骗,赶紧进来学习一下吧。 AMD专用内存简介 AMD专用内存是指那些采用服务器内存标准,或者干脆直接从废旧服务…

amd支持服务器内存,AMD专用内存和普通内存的区别是什么?

AMD专用内存和普通内存的区别是什么?很多伙伴在购买内存的时候,可能会看到“AMD专用内存”字样,那么AMD专用内存是什么意思呢?当然就是只有AMD平台能够使用,对于intel平台是使用不了的。由于很多伙伴都在疑惑AMD专用内存和普通内存有什么区别,下面小编就给大家说说吧! 一…

AMD规范

在读某第三方的源代码时,发现一个define()方法,随即开始了AMD语法的学习,随将学习成果分享如下: 一,ADM规范背景调查 前端技术在不断的发展之中,很多公司会开发自己的框架来用。开发一个自己会用的框架并…