O que jquery $ realmente retorna?

Eu li a documentação do JQuery e, embora muita atenção seja dedicada ao que você deve passar a função, não vejo nenhuma informação sobre o que ela realmente retorna .

Em particular, ele sempre retorna uma matriz, mesmo se apenas um elemento for encontrado? Ele retorna nulo quando nada é encontrado? Onde isso está documentado?

Eu entendo que os métodos jquery podem ser aplicados ao valor de retorno, mas e se eu quiser apenas usar o valor de retorno diretamente?

Da descrição de Rick Strahl :

O objeto jQuery: The Wrapped Set: Selectors retorna um objeto jQuery conhecido como "conjunto wrap", que é uma estrutura semelhante a um array que contém todos os elementos DOM selecionados. Você pode iterar sobre o conjunto empacotado como uma matriz ou acessar elementos individuais por meio do indexador ($ (sel) [0] por exemplo). Mais importante, você também pode aplicar funções jQuery a todos os elementos selecionados.

Sobre não devolver nada:

Ele sempre retorna um array? Ele retorna nulo?

Você sempre recebe a mesma coisa de volta, tenha ou não algum conteúdo, é a questão. Normalmente, você pode verificar isso usando .val () (por exemplo, $ ('. MyElem'). Val ())

Ele não retorna um array, ele retorna um objeto jQuery. O objeto jQuery é o que contém todos os métodos jQuery especiais.

Ele nunca retorna nulo ou outro tipo. Se um elemento for encontrado, o objeto jQuery terá apenas um filho. Se nenhum elemento for encontrado, o objeto jQuery estará vazio.

A função jQuery (ou seja, " $") sempre retorna um objeto jQuery em cada instância.

Como outro respondente mencionou, ele sempre retorna o objeto jQuery.

Este objeto sempre contém uma matriz de elementos (mesmo se for uma matriz vazia ou uma matriz com apenas um objeto).

Se desejar usar o objeto retornado "diretamente", como em, como um elemento simples, você pode fazer o seguinte:

$('selector')[0] // element
$('selector').get(0) // element
$('selector').length // number of elements in the array

Da documentação do jQuery :

O próprio objeto jQuery se comporta como um array; ele possui uma propriedade de comprimento e os elementos no objeto podem ser acessados ​​por seus índices numéricos [0] a [comprimento-1]. Observe que um objeto jQuery não é realmente um objeto Array Javascript, portanto, não possui todos os métodos de um objeto Array verdadeiro, como join ().

O fato de que $ () sempre retorna a função jQuery permite encadear chamadas de função jQuery criteriosamente.

Mecanismo seletor Jquery

$("..") , o seletor jquery, é usado para selecionar os elementos correspondentes.

Valor de retorno

Ele sempre retorna um objeto jquery semelhante a um array, que tem uma lengthpropriedade,

Método de chamada no objeto jquery retornado

Métodos de jquery podem ser chamados no objeto e se aplicam a esses elementos selecionados,

Acesse o elemento original por índice

Os elementos selecionados, são armazenados como propriedade do objeto, seus nomes de propriedade são números de índice iniciados em 0,
portanto , podem ser acessados ​​por índice, iniciam em 0,
após obter o elemento original, pode-se tratá-lo como se fosse obtido document.getElementXxx().

Envolva um elemento original em um objeto jquery

Depois de obter o elemento original, você pode envolvê-lo para ser um objeto jquery, chamando $(originalEle),
então você pode chamar métodos jquery no objeto embalado.

De acordo com o firebug, ele retorna uma matriz de objetos que correspondem ao seu seletor. Mas esse array é um objeto jQuery, que tem mais métodos do que um simples Array.

A documentação deles lista algumas das chamadas principais que você pode usar com "$" e o que eles retornam