Typescript namespace inside module - how to reference it?

Question

The type definition for the ngstorage library is as follows:

import * as angular from 'angular';

declare module 'angular' {
  export namespace storage {

    export interface IStorageService {
      //interface definition
    }

    export interface IStorageProvider extends angular.IServiceProvider {
      //interface definition
    }
  }
}

Three questions:

What exactly happens when the already-existing module 'angular' is declared again, as happens on line 3 of this example?
What does it mean to export a namespace inside a module definition export namespace storage?
How do I import IStorageService into my .ts files? Nothing I've tried so far works.

import { IStorageService } from 'ngstorage'

import { IStorageService } from 'angular.storage'

or just directly refer to IStorageService like so:

angular.storage.IStorageService

Nitzan Tomer · Accepted Answer · 2016-12-09 22:13:51Z

1

It's called Module Augmentation, and it's a way to add definitions to existing modules.
In this case, when you are importing the file that you posted it will add the new definitions to the angular module, just like the js file does at runtime.

You should be able to import it like so:

import * as angular from 'ngstorage';

let a: angular.storage.IStorageService;
...

Edit

Try:

import * as angular from 'angular';
import 'ngstorage';

let a: angular.storage.IStorageService;

edited Dec 9, 2016 at 22:13

answered Dec 9, 2016 at 0:15

Nitzan Tomer

166k51 gold badges330 silver badges307 bronze badges

Sign up to request clarification or add additional context in comments.

3 Comments

Jay Over a year ago

What's the significance of using the export keyword inside the module? Wouldn't just declaring the namespace add it to the module and make it available? Also, using angular.storage.IStorageService gives me the error "error TS2305: Module 'angular' has no exported member 'storage'."

Nitzan Tomer Over a year ago

Where did you get the .d.ts file from?

Jay Over a year ago

github.com/DefinitelyTyped/DefinitelyTyped/blob/types-2.0/… . Installed via npm @types/ngstorage

Collectives™ on Stack Overflow

Typescript namespace inside module - how to reference it?

1 Answer 1

Edit

3 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Edit

3 Comments

Your Answer

Sign up or log in

Post as a guest

Related