utils.tsx 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343
  1. import {Query} from 'history';
  2. import isArray from 'lodash/isArray';
  3. import isObject from 'lodash/isObject';
  4. import isString from 'lodash/isString';
  5. import isUndefined from 'lodash/isUndefined';
  6. import {Project} from 'sentry/types';
  7. import {EventTag} from 'sentry/types/event';
  8. import {appendTagCondition} from 'sentry/utils/queryString';
  9. function arrayIsEqual(arr?: any[], other?: any[], deep?: boolean): boolean {
  10. // if the other array is a falsy value, return
  11. if (!arr && !other) {
  12. return true;
  13. }
  14. if (!arr || !other) {
  15. return false;
  16. }
  17. // compare lengths - can save a lot of time
  18. if (arr.length !== other.length) {
  19. return false;
  20. }
  21. return arr.every((val, idx) => valueIsEqual(val, other[idx], deep));
  22. }
  23. export function valueIsEqual(value?: any, other?: any, deep?: boolean): boolean {
  24. if (value === other) {
  25. return true;
  26. }
  27. if (isArray(value) || isArray(other)) {
  28. if (arrayIsEqual(value, other, deep)) {
  29. return true;
  30. }
  31. } else if (isObject(value) || isObject(other)) {
  32. if (objectMatchesSubset(value, other, deep)) {
  33. return true;
  34. }
  35. }
  36. return false;
  37. }
  38. function objectMatchesSubset(obj?: object, other?: object, deep?: boolean): boolean {
  39. let k: string;
  40. if (obj === other) {
  41. return true;
  42. }
  43. if (!obj || !other) {
  44. return false;
  45. }
  46. if (deep !== true) {
  47. for (k in other) {
  48. if (obj[k] !== other[k]) {
  49. return false;
  50. }
  51. }
  52. return true;
  53. }
  54. for (k in other) {
  55. if (!valueIsEqual(obj[k], other[k], deep)) {
  56. return false;
  57. }
  58. }
  59. return true;
  60. }
  61. export function intcomma(x: number): string {
  62. return x.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
  63. }
  64. export function lastOfArray<T extends Array<unknown> | ReadonlyArray<unknown>>(
  65. t: T
  66. ): T[number] {
  67. return t[t.length - 1];
  68. }
  69. export function sortArray<T>(arr: Array<T>, score_fn: (entry: T) => string): Array<T> {
  70. arr.sort((a, b) => {
  71. const a_score = score_fn(a),
  72. b_score = score_fn(b);
  73. for (let i = 0; i < a_score.length; i++) {
  74. if (a_score[i] > b_score[i]) {
  75. return 1;
  76. }
  77. if (a_score[i] < b_score[i]) {
  78. return -1;
  79. }
  80. }
  81. return 0;
  82. });
  83. return arr;
  84. }
  85. export function objectIsEmpty(obj = {}): boolean {
  86. for (const prop in obj) {
  87. if (obj.hasOwnProperty(prop)) {
  88. return false;
  89. }
  90. }
  91. return true;
  92. }
  93. export function trim(str: string): string {
  94. return str.replace(/^\s+|\s+$/g, '');
  95. }
  96. /**
  97. * Replaces slug special chars with a space
  98. */
  99. export function explodeSlug(slug: string): string {
  100. return trim(slug.replace(/[-_]+/g, ' '));
  101. }
  102. export function defined<T>(item: T): item is Exclude<T, null | undefined> {
  103. return !isUndefined(item) && item !== null;
  104. }
  105. export function nl2br(str: string): string {
  106. return str.replace(/(?:\r\n|\r|\n)/g, '<br />');
  107. }
  108. /**
  109. * This function has a critical security impact, make sure to check all usages before changing this function.
  110. * In some parts of our code we rely on that this only really is a string starting with http(s).
  111. */
  112. export function isUrl(str: any): boolean {
  113. return (
  114. !!str &&
  115. isString(str) &&
  116. (str.indexOf('http://') === 0 || str.indexOf('https://') === 0)
  117. );
  118. }
  119. export function escape(str: string): string {
  120. return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
  121. }
  122. export function percent(value: number, totalValue: number): number {
  123. // prevent division by zero
  124. if (totalValue === 0) {
  125. return 0;
  126. }
  127. return (value / totalValue) * 100;
  128. }
  129. export function toTitleCase(str: string): string {
  130. return str.replace(
  131. /\w\S*/g,
  132. txt => txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase()
  133. );
  134. }
  135. /**
  136. * Note the difference between *a-bytes (base 10) vs *i-bytes (base 2), which
  137. * means that:
  138. * - 1000 megabytes is equal to 1 gigabyte
  139. * - 1024 mebibytes is equal to 1 gibibytes
  140. *
  141. * We will use base 10 throughout billing for attachments. This function formats
  142. * quota/usage values for display.
  143. *
  144. * For storage/memory/file sizes, please take a look at formatBytesBase2
  145. */
  146. export function formatBytesBase10(bytes: number, u: number = 0) {
  147. const units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
  148. const threshold = 1000;
  149. while (bytes >= threshold) {
  150. bytes /= threshold;
  151. u += 1;
  152. }
  153. return bytes.toLocaleString(undefined, {maximumFractionDigits: 2}) + ' ' + units[u];
  154. }
  155. /**
  156. * Note the difference between *a-bytes (base 10) vs *i-bytes (base 2), which
  157. * means that:
  158. * - 1000 megabytes is equal to 1 gigabyte
  159. * - 1024 mebibytes is equal to 1 gibibytes
  160. *
  161. * We will use base 2 to display storage/memory/file sizes as that is commonly
  162. * used by Windows or RAM or CPU cache sizes, and it is more familiar to the user
  163. *
  164. * For billing-related code around attachments. please take a look at
  165. * formatBytesBase10
  166. */
  167. export function formatBytesBase2(bytes: number): string {
  168. const units = ['KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
  169. const thresh = 1024;
  170. if (bytes < thresh) {
  171. return bytes + ' B';
  172. }
  173. let u = -1;
  174. do {
  175. bytes /= thresh;
  176. ++u;
  177. } while (bytes >= thresh);
  178. return bytes.toFixed(1) + ' ' + units[u];
  179. }
  180. export function getShortCommitHash(hash: string): string {
  181. if (hash.match(/^[a-f0-9]{40}$/)) {
  182. hash = hash.substr(0, 7);
  183. }
  184. return hash;
  185. }
  186. export function parseRepo<T>(repo: T): T {
  187. if (typeof repo === 'string') {
  188. const re = /(?:github\.com|bitbucket\.org)\/([^\/]+\/[^\/]+)/i;
  189. const match = repo.match(re);
  190. const parsedRepo = match ? match[1] : repo;
  191. return parsedRepo as any;
  192. }
  193. return repo;
  194. }
  195. /**
  196. * Converts a multi-line textarea input value into an array,
  197. * eliminating empty lines
  198. */
  199. export function extractMultilineFields(value: string): Array<string> {
  200. return value
  201. .split('\n')
  202. .map(f => trim(f))
  203. .filter(f => f !== '');
  204. }
  205. /**
  206. * If the value is of type Array, converts it to type string, keeping the line breaks, if there is any
  207. */
  208. export function convertMultilineFieldValue<T extends string | Array<string>>(
  209. value: T
  210. ): string {
  211. if (Array.isArray(value)) {
  212. return value.join('\n');
  213. }
  214. if (typeof value === 'string') {
  215. return value.split('\n').join('\n');
  216. }
  217. return '';
  218. }
  219. function projectDisplayCompare(a: Project, b: Project): number {
  220. if (a.isBookmarked !== b.isBookmarked) {
  221. return a.isBookmarked ? -1 : 1;
  222. }
  223. return a.slug.localeCompare(b.slug);
  224. }
  225. // Sort a list of projects by bookmarkedness, then by id
  226. export function sortProjects(projects: Array<Project>): Array<Project> {
  227. return projects.sort(projectDisplayCompare);
  228. }
  229. // build actorIds
  230. export const buildUserId = (id: string) => `user:${id}`;
  231. export const buildTeamId = (id: string) => `team:${id}`;
  232. /**
  233. * Removes the organization / project scope prefix on feature names.
  234. */
  235. export function descopeFeatureName<T>(feature: T): T | string {
  236. if (typeof feature !== 'string') {
  237. return feature;
  238. }
  239. const results = feature.match(/(?:^(?:projects|organizations):)?(.*)/);
  240. if (results && results.length > 0) {
  241. return results.pop()!;
  242. }
  243. return feature;
  244. }
  245. export function isWebpackChunkLoadingError(error: Error): boolean {
  246. return (
  247. error &&
  248. typeof error.message === 'string' &&
  249. error.message.toLowerCase().includes('loading chunk')
  250. );
  251. }
  252. export function deepFreeze<T>(object: T) {
  253. // Retrieve the property names defined on object
  254. const propNames = Object.getOwnPropertyNames(object);
  255. // Freeze properties before freezing self
  256. for (const name of propNames) {
  257. const value = object[name];
  258. object[name] = value && typeof value === 'object' ? deepFreeze(value) : value;
  259. }
  260. return Object.freeze(object);
  261. }
  262. export type OmitHtmlDivProps<P extends object> = Omit<
  263. React.HTMLProps<HTMLDivElement>,
  264. keyof P
  265. > &
  266. P;
  267. export function generateQueryWithTag(prevQuery: Query, tag: EventTag): Query {
  268. const query = {...prevQuery};
  269. // some tags are dedicated query strings since other parts of the app consumes this,
  270. // for example, the global selection header.
  271. switch (tag.key) {
  272. case 'environment':
  273. query.environment = tag.value;
  274. break;
  275. case 'project':
  276. query.project = tag.value;
  277. break;
  278. default:
  279. query.query = appendTagCondition(query.query, tag.key, tag.value);
  280. }
  281. return query;
  282. }
  283. export const isFunction = (value: any): value is Function => typeof value === 'function';
  284. // NOTE: only escapes a " if it's not already escaped
  285. export function escapeDoubleQuotes(str: string) {
  286. return str.replace(/\\([\s\S])|(")/g, '\\$1$2');
  287. }