@newteq/ngx-local-storage
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.1 • Public • Published

    ngx-local-storage

    NPM Version

    This is an angular library that provides a service to interact with local storage easily. Simply import the module and use NgxLocalStorageService to access local storage.

    Installation

    Install via npm:

    npm install @newteq/ngx-local-storage --save
    

    Usage

    1. Import NgxLocalStorageModule

    import { BrowserModule } from '@angular/platform-browser';
    import { NgModule } from '@angular/core';
    import { NgxLocalStorageModule } from 'ngx-localstorage';
    
    @NgModule({
        imports: [
            BrowserModule,
            NgxLocalStorageModule.forRoot()
        ],
        bootstrap: [AppComponent]
    })
    export class AppModule { }

    OR

    import { BrowserModule } from '@angular/platform-browser';
    import { NgModule } from '@angular/core';
    import { NgxLocalStorageModule } from 'ngx-localstorage';
    
    @NgModule({
        imports: [
            BrowserModule,
            NgxLocalStorageModule.forRoot({
    					prefix: 'my-prefix',
    					defaultJsonConversion: false,
    				})
        ],
        bootstrap: [AppComponent]
    })
    export class AppModule { }
    Configuration (NgxLocalStorageModule.forRoot(localStorageConfig))
    • localStorageConfig
      • Type: NgxLocalStorageConfig
        • Optional
    • NgxLocalstorageConfig Interface
      • prefix
        • Type: string
        • Determines the key prefix.
        • Default: ngx-local-storage
      • defaultJsonConversion
        • Type: boolean
        • Determines if the data is stored as a JSON object. (i.e. it is stored with JSON.stringify() and loaded with JSON.parse())
        • Default: true
      • nullUndefinedIsTheSame
        • Type: boolean
        • Determines if the service should try null and undefined as the same type. Usually would you want this to be the case, but you can change it.
        • Default: true
      • allowNullStorage
        • Type: boolean
        • Determines if null can be stored against a key. If null is passed to the setItem method, and this flag is true, it will save null to that key. By default it will remove the item if null is passed it the setItem as the default value is false. This works in conjuction with the nullUndefinedIsTheSame property and if this is true, the same behaviour will happen if undefined is passed in and this is set to true. It will remove the item rather than presisting it.
        • Default: false

    API

    LocalStorageService

    Methods

    • setItem(key: string, value: string): boolean: Adds tha value with the given key or updates an existing entry. Returns true if the item was added to the storage. Will return false if the item was not stored and was removed (as per the allowNullStorage property from the config)
    • getItem(key: string): T | any: Gets the entry specified by the given key.
    • removeItem(key: string): void: Removes the entry specified by the given key.
    • clear(): void: Clears all entries of the applications local storage.
    Example
    import { LocalStorageService } from '@newteq/ngx-local-storage';
    
    @Component({
      selector: 'app-storage-access',
      template: './storage-access.component.html'
    })
    export class StorageAccessComponent implements OnInit {
    
      constructor(private localStorageService: LocalStorageService) {
      }
      
      ngOnInit(): void {
    		this.localStorageService.set('key', 'value');
    		console.log(this.localStorageService.get('key'));
    		this.localStorageService.remove('key'); // or this.localStorageService.clear();
      }
    }

    Issues

    If you have any issues that you would like to log, please log them here

    Library

    Library Information

    This library was generated with Angular CLI version 7.2.0.

    Install

    npm i @newteq/ngx-local-storage

    DownloadsWeekly Downloads

    14

    Version

    1.0.1

    License

    UNLICENSE

    Unpacked Size

    105 kB

    Total Files

    32

    Last publish

    Collaborators

    • newteq-developer