An open API service indexing awesome lists of open source software.

https://github.com/mp3martin/js-parse-links


https://github.com/mp3martin/js-parse-links

gh-pages html javascript js parser web

Last synced: 11 months ago
JSON representation

Awesome Lists containing this project

README

          

[![CodeFactor](https://www.codefactor.io/repository/github/MP3Martin/js-parse-links/badge)](#/)
[](#/)
[](#/)
[](#/)
[](#/)

# js-parse-links

Todo:
- [x] Make the website look acceptable
- [x] System to get parameters and generate url
- [x] Loading icon
- [x] Use text in placeholders
- [x] Use APIs in placeholders _- (the main feature)_
- [x] Documentation
- [x] Add auto text wrapping (in display mode)
- [x] Add iframe mode (useful when you want the page to be refreshable)
- [ ] Downloading files
- [ ] Add more parameters

# Examples
* `https://mp3martin.github.io/js-parse-links/?url=https://google.{tld}/search?q={search}&placeholder=tld,com;search,Hello World!`
* goes to `https://www.google.com/search?q=Hello%20World!`


* `https://mp3martin.github.io/js-parse-links/?url={fact}&placeholder=fact,https://dog.ceo/api/breeds/image/random|message`
* goes to `https://images.dog.ceo/breeds/` _+ random dog image_


* `https://mp3martin.github.io/js-parse-links/?url=https://google.com/search?q=Tr*mp once said: "{fact}"&placeholder=fact,https://tronalddump.io/random/quote|value`
* goes to `https://www.google.com/search?q=Tr*mp%20once%20said:` _+ random fact_
* `https://mp3martin.github.io/js-parse-links/?url=Fun%20Fact:%20%7Bfact%7D%3Cbr%3E%3Cbr%3E%3Cbr%3E-'amp'nbsp'semi'%20'amp'nbsp'semi'Refresh%20to%20see%20more!&placeholder=fact,https://uselessfacts.jsph.pl/random.json?language=en|text&type=display`
* displays random fact
* `https://mp3martin.github.io/js-parse-links/?url=https://web.archive.org/web/20220605174851id_/http://www.milliondollarhomepage.com/&type=iframe`
* displays *The Million Dollar Webpage* without redirecting
* `https://mp3martin.github.io/js-parse-links/?url=Random%20number:%20{fact}&placeholder=fact,https://www.randomnumberapi.com/api/v1.0/random?min=0??max=100|0&type=display`
* displays random number

# Parameters
| Parameter | Default value | Type | Required | Description | Example value |
| ----------------- | ------------------------- | ------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `url` | :x: | string | :heavy_check_mark: | The target url | `https://www.google.com/search?q={search}` |
| `placeholder` | :x: | string | :x: | All the placeholders (in this format: `key,value;another_key,another_value`) | `search,Hello World!` |
| `type` | redirect | string | :x: | Type of redirection / thing to do after parsing the url (all possible values: `redirect`, `display`, `iframe`) | `redirect` |


# Other info
* By the way, this project does not have a backend (it is only a static site, everything happens client-side)
* Use this project for anything.
* Do not share `parse.mp3martin.xyz`, instead use `mp3martin.github.io/js-parse-links` because it may change.
* https://www.url-encode-decode.com is useful when you want to share the links on social media *(the links sometimes cannot contain special characters)* **❗only encode the part after `?url=`❗**

If you find this useful, you can show support by **⭐**ing this project or contributing to this project. (**not mandatory!**)