Angular URL parser

Angular service to get simple methods to manipulate url parts

Demo: http://yllieth.github.io/angular-url-parser/app/index.html

Rails gem: https://github.com/yllieth/angular_url_parser_rails

Installation

Bower

bower install yllieth/angular-url-parser --save

Once the lib is downloaded, add a reference in your index.html

<script type="application/javascript" src="../bower_components/angular-url-parser/angular-url-parser.js"></script>

Rails

In your Gemfile, add the following line:

gem'angular_url_parser_rails'

In your application.js, add the following line:

//= require angular-url-parser

Usage

angular.module('YOUR-ANGULAR-APP-NAME',['ngUrlParser']).controller('demoCtrl',function(urlParser){this.parts=urlParser.parse();this.protocol=urlParser.getProtocol();this.host=urlParser.getHost();this.hostname=urlParser.getHostname();this.port=urlParser.getPort();this.route=urlParser.getRoute();this.routeAttributes=urlParser.getRouteAttributes();this.queryString=urlParser.getQuerystring();this.option=urlParser.getOption();this.hash=urlParser.getHash();})

• getProtocol([string] url): string : Return the protocol of the given url - Example: "http:", "https:", ...
• getHost([string] url): string : Return the host of the given url (without port) - Example: "github.com", "localhost", ...
• getHostname([string] url): string : Return the hostname of the given url (with port) - Example: "github.com", "localhost:3000", ...
• getPort([string] url): string : Return the port of the given url - Example: "", "3000", ...
• getRoute([string] url): string : Return the main parts of the given url
• getRouteAttributes([string] url): array : Return the list of parts of the given url
• getQuerystring([string] url): string : Return the part of the given url with options
• getOption([string] param, [string] url): object|string : Return a specific option in the url's options, or all options in an object
• getHash([string] url): string : Return the hash of the given url
• parse([string] url): object : Return parsed url in an object:

  // urlParser.parse('http://localhost:3000/models?sort=asc#quantiles')
  {
  "protocol": "http:",
  "host": "localhost:3000",
  "hostname": "localhost",
  "port": "3000",
  "pathname": "/models",
  "search": "?sort=asc",
  "searchObject": { "sort": "asc" },
  "hash": "quantiles"
  }

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request