Monkey Requests

Useful library for sending requests.

23.06.2020 itibariyledir. En son verisyonu görün.

Bu script direkt olarak kurulamaz. Başka scriptler için bir kütüphanedir ve meta yönergeleri içerir // @require https://update.greasyfork.org/scripts/405822/819506/Monkey%20Requests.js

Bu betiği kurabilmeniz için Tampermonkey, Greasemonkey ya da Violentmonkey gibi bir kullanıcı betiği eklentisini kurmanız gerekmektedir.

You will need to install an extension such as Tampermonkey to install this script.

Bu betiği kurabilmeniz için Tampermonkey ya da Violentmonkey gibi bir kullanıcı betiği eklentisini kurmanız gerekmektedir.

Bu betiği kurabilmeniz için Tampermonkey ya da Userscripts gibi bir kullanıcı betiği eklentisini kurmanız gerekmektedir.

Bu betiği indirebilmeniz için ayrıca Tampermonkey gibi bir eklenti kurmanız gerekmektedir.

Bu komut dosyasını yüklemek için bir kullanıcı komut dosyası yöneticisi uzantısı yüklemeniz gerekecek.

(Zaten bir kullanıcı komut dosyası yöneticim var, kurmama izin verin!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(Zateb bir user-style yöneticim var, yükleyeyim!)

// ==UserScript==
// @name Monkey Requests
// @namespace https://rafaelgssa.gitlab.io/monkey-scripts
// @version 1.0.3
// @author rafaelgssa
// @description Useful library for sending requests.
// @match *://*/*
// @require https://greasemonkey.github.io/gm4-polyfill/gm4-polyfill.js
// @require https://greasyfork.org/scripts/405802-monkey-dom/code/Monkey%20DOM.js
// @require https://greasyfork.org/scripts/405813-monkey-utils/code/Monkey%20Utils.js
// @grant GM.xmlHttpRequest
// @grant GM_xmlhttpRequest
// ==/UserScript==

/* global MonkeyDom, MonkeyUtils */

/**
 * @typedef {'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE'} RequestMethod
 * @typedef {Object} MonkeyResponse
 * @property {string} url
 * @property {string} text
 * @property {Object} [json]
 * @property {Document} [dom]
 * @typedef {{ [K in RequestMethod]: (url: string, options?: RequestInit | GM.Request) => Promise<MonkeyResponse> }} ShorthandSend
 */

// eslint-disable-next-line
const MonkeyRequests = (() => {
	/** @type {RequestMethod[]} */
	const methods = ['CONNECT', 'DELETE', 'GET', 'HEAD', 'OPTIONS', 'PATCH', 'POST', 'PUT', 'TRACE'];

	/**
	 * @param {RequestMethod} method
	 * @param {string} url
	 * @param {RequestInit | GM.Request} [options]
	 * @returns {Promise<MonkeyResponse>}
	 */
	const _sendWithMethod = (method, url, options = {}) => {
		return send(url, { ...options, method });
	};

	/**
	 * @param {string} url
	 * @param {RequestInit | GM.Request} [options]
	 * @returns {Promise<MonkeyResponse>}
	 */
	const send = (url, options = {}) => {
		if (_isInternal(url, options)) {
			return _sendInternal(url, options);
		}
		return _sendExternal(url, options);
	};

	/**
	 * Checks if the request is internal (uses window.fetch) or external (uses GM.xmlHttpRequest to bypass CORS).
	 * @param {string} url
	 * @param {RequestInit | GM.Request} options
	 * @returns {options is RequestInit}
	 */
	// eslint-disable-next-line
	const _isInternal = (url, options) => {
		return url.includes(window.location.host);
	};

	/**
	 * @param {string} url
	 * @param {RequestInit} options
	 * @returns {Promise<MonkeyResponse>}
	 */
	const _sendInternal = async (url, options) => {
		const [internalFetch, internalOptions] = _getInternalObjects(options);
		const fetchResponse = await internalFetch(url, internalOptions);
		/** @type {MonkeyResponse} */
		const response = {
			url: fetchResponse.url,
			text: await fetchResponse.text(),
		};
		return _processResponse(response);
	};

	/**
	 * Allows the request to be made in the current Firefox container.
	 * @param {RequestInit} options
	 * @returns {[Function, RequestInit]}
	 */
	const _getInternalObjects = (options) => {
		if ('wrappedJSObject' in window) {
			window.wrappedJSObject.options = cloneInto(options, window);
			return [window.wrappedJSObject.fetch, window.wrappedJSObject.options];
		}
		return [window.fetch, options];
	};

	/**
	 * @param {string} url
	 * @param {Partial<GM.Request>} options
	 * @returns {Promise<MonkeyResponse>}
	 */
	const _sendExternal = (url, options) => {
		return new Promise((resolve) => {
			GM.xmlHttpRequest({
				url,
				method: 'GET',
				...options,
				onload: (gmResponse) => {
					/** @type {MonkeyResponse} */
					const response = {
						url: gmResponse.finalUrl,
						text: gmResponse.responseText,
					};
					resolve(_processResponse(response));
				},
			});
		});
	};

	/**
	 * @param {MonkeyResponse} response
	 * @returns {MonkeyResponse}
	 */
	const _processResponse = (response) => {
		const processedResponse = { ...response };
		try {
			processedResponse.dom = MonkeyDom.parse(response.text);
		} catch (err) {
			// Response is not a DOM, just ignore.
		}
		try {
			processedResponse.json = JSON.parse(response.text);
		} catch (err) {
			// Response is not a JSON, just ignore.
		}
		return processedResponse;
	};

	/**
	 * Parses a query string into an object.
	 * @param {string} query The query to parse.
	 * @returns {Record<string, string>} The parsed object.
	 */
	const parseQuery = (query) => {
		/** @type {Record<string, string>} */
		const params = {};
		const rawQuery = query.startsWith('?') ? query.slice(1) : query;
		const parts = rawQuery.split('&').filter(MonkeyUtils.isSet);
		for (const part of parts) {
			const [key, value] = part.split('=').filter(MonkeyUtils.isSet);
			params[key] = value;
		}
		return params;
	};

	/**
	 * Converts an object to a query string.
	 * @param {Record<string, unknown>} obj The object to convert.
	 * @returns {string} The converted query string, without '?'.
	 */
	const convertToQuery = (obj) => {
		return Object.entries(obj)
			.map((entry) => entry.join('='))
			.join('&');
	};

	/** @type {ShorthandSend} */
	// @ts-ignore
	const shorthandSend = {};
	for (const method of methods) {
		shorthandSend[method] = _sendWithMethod.bind(null, method);
	}

	return {
		...shorthandSend,
		parseQuery,
		convertToQuery,
		send,
	};
})();