# queried

> Query selector CSS4 +

Latest version **1.4.5** (published 2015-10-21) · Unlicensed license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install queried
pnpm add queried
yarn add queried
bun add queried
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.4.5 |
| Published | 2015-10-21 |
| First published | 2015-01-28 |
| Weekly downloads | 0 |
| License | Unlicensed |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 8 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Deema Ywanov |
| Maintainers | dfcreative |

## Links

- npm: https://www.npmjs.com/package/queried
- Repository: https://github.com/dfcreative/queried
- Issues: https://github.com/dfcreative/queried/issues
- npm.io page: https://npm.io/package/queried

## Dependencies (8)

- [mutype](https://npm.io/package/mutype.md) ^0.3.9
- [sliced](https://npm.io/package/sliced.md) 0.0.5
- [get-doc](https://npm.io/package/get-doc.md) ^1.0.0
- [get-uid](https://npm.io/package/get-uid.md) ^1.0.1
- [arr-flatten](https://npm.io/package/arr-flatten.md) ^1.0.0
- [parenthesis](https://npm.io/package/parenthesis.md) ^1.2.3
- [array-unique](https://npm.io/package/array-unique.md) ^0.1.1
- [arrayify-compact](https://npm.io/package/arrayify-compact.md) ^0.1.0

## Recent versions

- 1.4.5 (latest) — 2015-10-21
- 1.4.4 — 2015-06-29
- 1.4.3 — 2015-06-29
- 1.4.2 — 2015-06-29
- 1.4.1 — 2015-01-31
- 1.4.0 — 2015-01-31
- 1.3.3 — 2015-01-31
- 1.3.2 — 2015-01-31
- 1.3.1 — 2015-01-31
- 1.3.0 — 2015-01-31
- 1.2.3 — 2015-01-31
- 1.2.2 — 2015-01-31
- 1.2.1 — 2015-01-30
- 1.2.0 — 2015-01-28
- 1.1.2 — 2015-01-28
- … 4 more at https://npm.io/package/queried/versions

## README

# queried [![Build Status](https://travis-ci.org/dfcreative/queried.svg?branch=master)](https://travis-ci.org/dfcreative/queried) [![Code Climate](https://codeclimate.com/github/dfcreative/queried/badges/gpa.svg)](https://codeclimate.com/github/dfcreative/queried)

_Queried_ is a convenient wrapper for _querySelector_.

7. [query](https://github.com/component/query)-compliant API.

3. Returns `Array` instead of `NodeList` in multiple query: `q.all('.block').forEach(function (el) { ... } )`.

7. Accepts other elements or array as a selector: `q.all(['.block', self.el]);`.

1. Polyfills CSS3 & CSS4 pseudos: `:has`, `:scope`, `:root`, `:matches`.

2. Fixes immediate children selector `> *`: `q.all('> *', element);`.

7. Normalizes nested :not’s: `:not(a:not(:target))`.


## Usage

[![npm install queried](https://nodei.co/npm/queried.png?mini=true)](https://npmjs.org/package/queried)


```js
var q = require('queried');

//select each div having `a` with `span` inside as immediate children.
q.all('div:has(a:has(span))');
```

## API

| Method | Description |
|---|---|
| _query(selector, el=document)_ | Query a single element by selector |
| _query.all(selector, el=document)_ | Query list of elements by selector |
| _query.document_ | Default document to use. Change it, if you need custom DOM, like `q.document = require('dom-lite').document`. |


## Similar

* [sel](https://github.com/amccollum/sel) — a more complete CSS4 selector, lacks of mapping pseudos and unable to handle nested pseudos like `:not(:has(a))`
* [query-component](http://npmjs.org/package/query-component) - a tiny wrapper over native `querySelector` with fallback to engines like qwery etc.
* [dom-select](https://www.npmjs.com/package/dom-select) === [select-dom](https://www.npmjs.com/package/select-dom)
* [qwery](https://www.npmjs.com/package/qwery)
* [domy-element](https://www.npmjs.com/package/domy-element)
* [jquery](https://www.npmjs.com/package/jquery)

---
_Source: https://npm.io/package/queried · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._