npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

parasitejs

v1.0.3

Published

Use javascript the way you want, fast as possible.

Downloads

15

Readme

Objective

Now, more than ever, you do not need jQuery to manipulate HTML elements and their events. The ParasiteJS library consumes HTML elements, nodelists, and collections by adding key query and iteration functions, focusing on performance and agility in development.

Performance

All added functions aim to approach vanilla performance.

Agility in Development

When talking about agility, vanilla is more inefficient than all query libraries (for this, they exist :P).

The javascript does not have functions to manipulate the lists returned by the search of elements (querySelectorAll, getElements ...) forcing you to create functions to do this.

The ParasiteJS functions are available in collections and elements making these functions always available into the elements. The functions are based on jQuery but are NOT compatible, so check out the documentation below.

Warning

This project does not objective the module creation. This is a lightweight and faster alternative than jQuery for "Do not use jQuery" projects where jQuery is not a dependency.

Install

    npm i parasitejs

How to use

Module

Require parasitejs and he goes modify lists, collections and elements:

    const { p$ } = require('parasitejs')

    p$(() => {

        // Same as document.find
        let $el = p$('tag.class#id[attr="value"]')

        $el = $el.find('selector')

        $el .findTag('tag')     // Return collection
            .findId('id')       // Return element
            .findClass('class') // Return collection 
            .find('selector')   // Return list
            .css({ style: 'value' });

    })

Web

Download script into /dist/web/ folder and import normally:

    <script type="text/javascript" src="parasite.min.js"/>

    <script>
        p$(() => { 

            // Same as document.find
            let $el = p$('tag.class#id[attr="value"]')

            $el = $el.find('selector')

            $el .findTag('tag')     // Return collection
                .findId('id')       // Return element
                .findClass('class') // Return collection 
                .find('selector')   // Return list
                .css({ style: 'value' });

        });
    </script>

Pseudo jQuery-like Function

The ParasiteJS create a variable called p$. That provides static functions and an constructor.

jQuery-like Function

    // Find selector and return collection
    p$(selector: string): ParasitedList | NodeList | HTMLCollection

    // on ready callback
    p$(handler: Function): void

    // Array of HTMLElements
    p$(elemArr: HTMLElement[]): ParasitedList

    // HTML Element
    p$(elem: HTMLElement): ParasitedList

Static Helpers

    // DOM Ready
    p$.ready(fn: Function): void

    // Each lists and collections with length
    p$.each(list: ArrayLike<any>, iterator: (keyIndex: string|number, value: any) => boolean): ArrayLike<any>

Javascript Helpers

    // Load other js files with javascript
    p$.require(filePath: string): void

    // Load javascript code
    p$.globalEval(code: string): void

AJAX

    // Ajax jQuery-like
    p$.ajax(url?: string, settings: AJAXSettings): Deferred

    // GET URL
    p$.get(url: string, data?: any, success: AJAXSuccess): Deferred
    p$.get(settings: AJAXSettings): Deferred

    // POST URL
    p$.post(url: string, data: any, success: AJAXSuccess): Deferred
    p$.post(settings: AJAXSettings): Deferred

Promise

    // Deferred jQuery-like
    p$.Deferred(beforeStart?: Function): Deferred

Functions

All

    let obj: Document | HTMLElement | Window | NodeList | HTMLCollection

    // Attach an event handler function for one or more events.
    obj.on(events: string, selector?: string, handler: Function): this

    // Attach a handler to an event for the elements.
    // The handler is executed at most once per element
    // per event type.
    obj.one(events: string, selector?: string, handler: Function): this

    // Remove an event handler.
    obj.off(events: string, selector?: string, handler: Function): this

    // Execute all handlers and behaviors attached.
    obj.trigger(events: string, data?: any): this

Document, HTMLElement, NodeList, HTMLCollection

    let obj: Document | HTMLElement | NodeList | HTMLCollection

    // Execute getElementById (and filter if needed).
    obj.findId(id: string): Element | null

    // Execute getElementsByName.
    obj.findName(name: string): NodeList

    // Execute getElementsByTag.
    obj.findTag(tag: string): HTMLCollection

    // Execute getElementsByClass.
    obj.findClass(clss: string): HTMLCollection

    // Execute querySelector.
    obj.findOne(selector: string): Element | null

    // Forced querySelectorAll.
    obj.findAll(selector: string): NodeList

    // Optimized querySelectorAll (just execute
    // querySelectorAll if needed).
    obj.find(selector: string): NodeList | HTMLCollection | ParasitedList

NodeList, HTMLCollection

    let list: NodeList | HTMLCollection

    // Reduce the set of matched elements by selector
    // or test function.
    list.filter(selector: string | Function): ParasitedList

    // Retrieve one of the elements matched.
    list.get(index?: number): HTMLElement | void

    // Iterate over the list, executing a function
    // for each matched element.
    list.each(handler: EachIterator): this

HTMLElement

    let elem: HTMLElement

    // Set one or more attributes for the set
    // of matched elements or get first element attribute.
    elem.attr(attrs: PlainObject | string, value?: string): this | string

    // Remove an attribute from each element
    // in the set of matched elements.
    elem.removeAttr(attrNames: string): this

    // Set one or more properties for the set of
    // matched elements or get first element prop.
    elem.prop(props: PlainObject | string, value?: string): this | string

    // Remove a property for the set of matched elements.
    elem.removeProp(propNames: string): this

    // Set the value of each element in the set of
    // matched elements or get first element value.
    elem.val(value?: string): this | string

    // Store arbitrary data associated with the matched
    // elements or get first element data.
    elem.data(data: PlainObject | string, value?: string): this | string

    // Get the computed style properties for the first
    // element in the set of matched elements.
    elem.css(styles: PlainObject | string, value?: string): this | string

    // Check the current matched set of elements for
    // selector or test function.
    elem.is(filter: string | Function): boolean

Author

License