jQuery offset方法源码参数判断逻辑与功能复用疑问

你提到的源码片段整理如下：

// offset() relates an element's border box to the document origin
offset: function( options ) {

    // Preserve chaining for setter
    if ( arguments.length ) {
        return options === undefined ?
            this :
            this.each( function( i ) {
                jQuery.offset.setOffset( this, options, i );
            } );
    }
    // 后续为读取偏移的逻辑
    ...
}

设计逻辑解答 #

这个设计是jQuery的典型API风格：同一方法同时承担读、写两种能力，和css()、attr()、html()、val()等常用方法的设计逻辑完全一致，不需要用户为同一种语义的操作单独记忆getOffset、setOffset两个不同方法。

这段前置判断的分支逻辑对应三种调用场景：

• 不传任何参数调用$(selector).offset()：arguments.length为0，跳过当前判断分支，执行后续读取逻辑，最终返回匹配元素中第一个元素相对于文档根节点的{top: Number, left: Number}坐标对象
• 传入undefined调用$(selector).offset(undefined)：直接返回当前jQuery对象，不执行任何读写操作，保证链式调用不中断
• 传入有效配置调用$(selector).offset({top: 100, left: 100})：遍历所有匹配元素调用setOffset修改偏移，操作完成后返回当前jQuery对象，支持后续链式调用其他方法

设计初衷 #

jQuery在早期设计时就遵循「最小记忆成本」的原则，同类语义的读写操作合并为同一个API，仅通过入参区分行为，既降低了用户的学习门槛，也统一了全库的调用风格。你在注释里看到的Preserve chaining for setter也明确标注了，这个分支的核心作用就是保证写场景下的链式调用能力，符合jQuery的编码习惯。

内容的提问来源于stack exchange，提问作者alancc