theluyuan/Web
1
0
Fork 1
mirror of https://github.com/qianguyihao/Web.git synced 2024-10-30 04:24:44 +08:00
Code Issues Projects Releases Wiki Activity
5e3679a89c
Web/10-ES6/07-ES6：Promise入门详解.md

625 lines
22 KiB
Markdown
Raw Normal View History

modify
2018-03-17 12:10:41 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
## 异步调用
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
### 异步
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
JavaScript的执行环境是**单线程**。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
所谓单线程，是指JS引擎中负责解释和执行JavaScript代码的线程只有一个，也就是一次只能完成一项任务，这个任务执行完后才能执行下一个，它会「阻塞」其他任务。这个任务可称为主线程。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
异步模式可以一起执行**多个任务**。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
常见的异步模式有以下几种：
- 定时器
- 接口调用
- 事件函数
今天这篇文章，我们重点讲一下**接口调用**。接口调用里，重点讲一下**Promise**。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
### 接口调用的方式
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
js 中常见的接口调用方式，有以下几种：
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update: Promise
2020-04-07 20:42:03 +08:00
- 原生ajax
- 基于jQuery的ajax
- Fetch
- Promise
- axios
### 多次异步调用的依赖分析
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 多次异步调用的结果，顺序可能不同步。
update: Promise
2020-04-07 20:42:03 +08:00
- 异步调用的结果如果**存在依赖**，则需要嵌套。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
在ES5中，当进行多层嵌套回调时，会导致代码层次过多，很难进行维护和二次开发；而且会导致**回调地狱**的问题。ES6中的Promise 就可以解决这两个问题。
update: Promise
2020-04-07 20:42:03 +08:00
## Promise 概述
### Promise的介绍和优点
ES6中的Promise 是异步编程的一种方案。从语法上讲，Promise 是一个对象，它可以获取异步操作的消息。
Promise对象, 可以**将异步操作以同步的流程表达出来**。使用 Promise 主要有以下好处：
- 可以很好地解决**回调地狱**的问题（避免了层层嵌套的回调函数）。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 语法非常简洁。Promise 对象提供了简洁的API，使得控制异步操作更加容易。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add file:变量提升
2018-03-21 21:45:10 +08:00
### 回调地狱的举例
假设买菜、做饭、洗碗都是异步的。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
但真实的场景中，实际的操作流程是：买菜成功之后，才能开始做饭。做饭成功后，才能开始洗碗。这里面就涉及到了多层嵌套调用，也就是回调地狱。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
## Promise 的基本用法
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
（1）使用new实例化一个Promise对象，Promise的构造函数中传递一个参数。这个参数是一个函数，该函数用于处理异步任务。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
（2）并且传入两个参数：resolve和reject，分别表示异步执行成功后的回调函数和异步执行失败后的回调函数；
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
（3）通过 promise.then() 处理返回结果。这里的 p 指的是 Promise实例。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
代码举例如下：
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script>
// 第一步：model层的接口封装
const promise = new Promise((resolve, reject) => {
// 这里做异步任务（比如ajax 请求接口。这里暂时用定时器代替）
setTimeout(function() {
var data = { retCode: 0, msg: 'qianguyihao' }; // 接口返回的数据
if (data.retCode == 0) {
// 接口请求成功时调用
resolve(data);
} else {
// 接口请求失败时调用
reject({ retCode: -1, msg: 'network error' });
}
}, 100);
});
// 第二步：业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的，也就是从接口拿到的数据
promise.then(data => {
// 从 resolve 获取正常结果
console.log(data);
}).catch(data => {
// 从 reject 获取异常结果
console.log(data);
});
</script>
</body>
</html>
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
```
上方代码中，当从接口返回的数据`data.retCode`的值不同时，可能会走 resolve，也可能会走 reject，这个由你自己的业务决定。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
## promise对象的3个状态（了解即可）
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 初始化状态（等待状态）：pending
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 成功状态：fullfilled
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 失败状态：rejected
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
（1）当new Promise()执行之后，promise对象的状态会被初始化为`pending`，这个状态是初始化状态。`new Promise()`这行代码，括号里的内容是同步执行的。括号里定义一个function，function有两个参数：resolve和reject。如下：
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 如果请求成功了，则执行resolve()，此时，promise的状态会被自动修改为fullfilled。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- 如果请求失败了，则执行reject()，此时，promise的状态会被自动修改为rejected
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add file:变量提升
2018-03-21 21:45:10 +08:00
（2）promise.then()方法，括号里面有两个参数，分别代表两个函数 function1 和 function2：
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add file:变量提升
2018-03-21 21:45:10 +08:00
- 如果promise的状态为fullfilled（意思是：如果请求成功），则执行function1里的内容
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add file:变量提升
2018-03-21 21:45:10 +08:00
- 如果promise的状态为rejected（意思是，如果请求失败），则执行function2里的内容
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
另外，resolve()和reject()这两个方法，是可以给promise.then()传递参数的。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
完整代码举例如下：
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
```javascript
let promise = new Promise((resolve, reject) => {
//进来之后，状态为pending
console.log('111'); //这行代码是同步的
//开始执行异步操作（这里开始，写异步的代码，比如ajax请求 or 开启定时器）
if (异步的ajax请求成功) {
console.log('333');
resolve('haha');//如果请求成功了，请写resolve()，此时，promise的状态会被自动修改为fullfilled
} else {
reject('555');//如果请求失败了，请写reject()，此时，promise的状态会被自动修改为rejected
}
})
console.log('222');
//调用promise的then()
promise.then((successMsg) => {
//如果promise的状态为fullfilled，则执行这里的代码
console.log(successMsg, '成功了');
}
, (errorMsg) => {
//如果promise的状态为rejected，则执行这里的代码
console.log(errorMsg, '失败了');
}
)
```
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
## 基于 Promise 处理 多次 Ajax 请求（链式调用）【重要】
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
实际开发中，我们经常需要同时请求多个接口。比如说：在请求完`接口1`的数据`data1`之后，需要根据`data1`的数据，继续请求接口2，获取`data2`；然后根据`data2`的数据，继续请求接口3。
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
换而言之，现在有三个网络请求，请求2必须依赖请求1的结果，请求3必须依赖请求2的结果，如果按照往常的写法，会有三层回调，会陷入“回调地狱”。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
这种场景其实就是接口的多层嵌套调用。有了 Promise 之后，我们可以把多层嵌套调用按照**线性**的方式进行书写，非常优雅。也就是说：Promise 可以把原本的**多层嵌套调用**改进为**链式调用**。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
代码举例：（多次 Ajax请求，链式调用）
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
<script>
const request = require('request');
// Promise 封装接口
const request1 = function() {
const promise = new Promise(resolve => {
request('https://www.baidu.com', function(response) {
if (response.retCode == 200) {
resolve('request1 success');
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
} else {
reject('接口请求失败');
}
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
});
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
});
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
return promise;
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
};
const request2 = function() {
const promise = new Promise(resolve => {
request('https://www.jd.com', function(response) {
if (response.retCode == 200) {
resolve('request2 success');
} else {
reject('接口请求失败');
}
});
});
return promise;
};
const request3 = function() {
const promise = new Promise(resolve => {
request('https://www.taobao.com', function(response) {
if (response.retCode == 200) {
resolve('request3 success');
} else {
reject('接口请求失败');
}
});
});
return promise;
};
// 先发起request1，等resolve后再发起request2；紧接着，等 request2有了 resolve之后，再发起 request3
request1()
.then(data => {
console.log(data);
return request2();
})
.then(data => {
console.log(data);
return request3();
})
.then(data => {
console.log(data);
});
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
</script>
</body>
</html>
modify
2018-03-17 12:10:41 +08:00
```
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
上面代码中，then是可以链式调用的，后面的then可以拿到前面resolve出来的数据。
这个举例很经典，需要多看几遍。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
## return 的函数返回值
return 后面的返回值，有两种情况：
- 情况1：返回 Promise 实例对象。返回的该实例对象会调用下一个 then。
- 情况2：返回普通值。返回的普通值会直接传递给下一个then，通过 then 参数中函数的参数接收该值。
我们针对上面这两种情况，详细解释一下。
### 情况1：返回 Promise 实例对象
举例如下：（这个例子，跟上一段 Ajax 链式调用 的例子差不多）
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script type="text/javascript">
/*
基于Promise发送Ajax请求
*/
function queryData(url) {
return new Promise((resolve, reject) => {
var xhr = new XMLHttpRequest();
xhr.onreadystatechange = function() {
if (xhr.readyState != 4) return;
if (xhr.readyState == 4 && xhr.status == 200) {
// 处理正常情况
resolve(xhr.responseText);
} else {
// 处理异常情况
reject('接口请求失败');
}
};
xhr.responseType = 'json'; // 设置返回的数据类型
xhr.open('get', url);
xhr.send(null); // 请求接口
});
}
// 发送多个ajax请求并且保证顺序
queryData('http://localhost:3000/api1')
.then(
data1 => {
console.log(JSON.stringify(data1));
return queryData('http://localhost:3000/api2');
},
error1 => {
console.log(error1);
}
)
.then(
data2 => {
console.log(JSON.stringify(data2));
// 这里的 return，返回的是 Promise 实例对象
return new Promise((resolve, reject) => {
resolve('qianguyihao');
});
},
error2 => {
console.log(error2);
}
)
.then(data3 => {
console.log(data3);
});
</script>
</body>
</html>
modify
2018-03-17 12:10:41 +08:00
```
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
### 情况2：返回 普通值
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script type="text/javascript">
/*
基于Promise发送Ajax请求
*/
function queryData(url) {
return new Promise((resolve, reject) => {
var xhr = new XMLHttpRequest();
xhr.onreadystatechange = function() {
if (xhr.readyState != 4) return;
if (xhr.readyState == 4 && xhr.status == 200) {
// 处理正常情况
resolve(xhr.responseText);
} else {
// 处理异常情况
reject('接口请求失败');
}
};
xhr.responseType = 'json'; // 设置返回的数据类型
xhr.open('get', url);
xhr.send(null); // 请求接口
});
}
// 发送多个ajax请求并且保证顺序
queryData('http://localhost:3000/api1')
.then(
data1 => {
console.log(JSON.stringify(data1));
return queryData('http://localhost:3000/api2');
},
error1 => {
console.log(error1);
}
)
.then(
data2 => {
console.log(JSON.stringify(data2));
// 返回普通值
return 'qianguyihao';
},
error2 => {
console.log(error2);
}
)
/*
既然上方返回的是 普通值，那么，这里的 then 是谁来调用呢？
答案是：这里会产生一个新的 默认的 promise实例，来调用这里的then，确保可以继续进行链式操作。
*/
.then(data3 => {
// 这里的 data3 接收的是 普通值 'qianguyihao'
console.log(data3);
});
</script>
</body>
</html>
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
```
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
## Promise 的常用API：实例方法【重要】
Promise 自带的API提供了如下实例方法：
- promise.then()：获取异步任务的正常结果。
- promise.catch()：获取异步任务的异常结果。
- promise.finaly()：异步任务无论成功与否，都会执行。
代码举例如下。
写法1：
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script>
function queryData() {
return new Promise((resolve, reject) => {
setTimeout(function() {
var data = { retCode: 0, msg: 'qianguyihao' }; // 接口返回的数据
if (data.retCode == 0) {
// 接口请求成功时调用
resolve(data);
} else {
// 接口请求失败时调用
reject({ retCode: -1, msg: 'network error' });
}
}, 100);
});
}
queryData()
.then(data => {
// 从 resolve 获取正常结果
console.log('接口请求成功时，走这里');
console.log(data);
})
.catch(data => {
// 从 reject 获取异常结果
console.log('接口请求失败时，走这里');
console.log(data);
})
.finally(() => {
console.log('无论接口请求成功与否，都会走这里');
});
</script>
</body>
</html>
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
update
2018-03-17 12:22:00 +08:00
```
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
写法2：（和上面的写法1等价）
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script>
function queryData() {
return new Promise((resolve, reject) => {
setTimeout(function() {
var data = { retCode: 0, msg: 'qianguyihao' }; // 接口返回的数据
if (data.retCode == 0) {
// 接口请求成功时调用
resolve(data);
} else {
// 接口请求失败时调用
reject({ retCode: -1, msg: 'network error' });
}
}, 100);
});
}
queryData()
.then(
data => {
// 从 resolve 获取正常结果
console.log('接口请求成功时，走这里');
console.log(data);
},
data => {
// 从 reject 获取异常结果
console.log('接口请求失败时，走这里');
console.log(data);
}
)
.finally(() => {
console.log('无论接口请求成功与否，都会走这里');
});
</script>
</body>
</html>
modify
2018-03-17 12:10:41 +08:00
update
2018-03-17 12:22:00 +08:00
```
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
**注意**：写法1和写法2的作用是完全等价的。只不过，写法2是把 catch 里面的代码作为 then里面的第二个参数而已。
## Promise 的常用API：对象方法【重要】
Promise 自带的API提供了如下对象方法：
- Promise.all()：并发处理多个异步任务，所有任务都执行成功，才能得到结果。
- Promise.race(): 并发处理多个异步任务，只要有一个任务执行成功，就能得到结果。
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
下面来详细介绍。
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
### Promise.all() 代码举例
代码举例：
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script type="text/javascript">
/*
封装 Promise 接口调用
*/
function queryData(url) {
return new Promise((resolve, reject) => {
var xhr = new XMLHttpRequest();
xhr.onreadystatechange = function() {
if (xhr.readyState != 4) return;
if (xhr.readyState == 4 && xhr.status == 200) {
// 处理正常结果
resolve(xhr.responseText);
} else {
// 处理异常结果
reject('服务器错误');
}
};
xhr.open('get', url);
xhr.send(null);
});
}
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
var promise1 = queryData('http://localhost:3000/api1');
var promise2 = queryData('http://localhost:3000/api2');
var promise3 = queryData('http://localhost:3000/api3');
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
Promise.all([promise1, promise2, promise3]).then(result => {
console.log(result);
});
</script>
</body>
</html>
update
2018-03-17 12:22:00 +08:00
```
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
### Promise.race() 代码举例
代码举例：
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
</head>
<body>
<script type="text/javascript">
/*
封装 Promise 接口调用
*/
function queryData(url) {
return new Promise((resolve, reject) => {
var xhr = new XMLHttpRequest();
xhr.onreadystatechange = function() {
if (xhr.readyState != 4) return;
if (xhr.readyState == 4 && xhr.status == 200) {
// 处理正常结果
resolve(xhr.responseText);
} else {
// 处理异常结果
reject('服务器错误');
}
};
xhr.open('get', url);
xhr.send(null);
});
}
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
var promise1 = queryData('http://localhost:3000/api1');
var promise2 = queryData('http://localhost:3000/api2');
var promise3 = queryData('http://localhost:3000/api3');
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
Promise.race([promise1, promise2, promise3]).then(result => {
console.log(result);
});
</script>
</body>
</html>
add file:变量提升
2018-03-21 21:45:10 +08:00
```
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
了解这些内容之后， Promise 的基本用法，你就已经掌握了。
add file:变量提升
2018-03-21 21:45:10 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
## 参考链接
add file:变量提升
2018-03-21 21:45:10 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
- [当面试官问你Promise的时候，他究竟想听到什么？](https://zhuanlan.zhihu.com/p/29235579)
add file:变量提升
2018-03-21 21:45:10 +08:00
update: Promise 链式调用
2020-04-08 16:20:38 +08:00
- [手写一个Promise/A+,完美通过官方872个测试用例](https://www.cnblogs.com/dennisj/p/12660388.html)
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
## 我的公众号
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
想学习**代码之外的技能**？不妨关注我的微信公众号：**千古壹号**（id：`qianguyihao`）。
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
扫一扫，你将发现另一个全新的世界，而这将是一场美丽的意外：
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
add: Promise 链式调用
2020-04-08 15:41:07 +08:00
![](http://img.smyhvae.com/20200101.png)
add：（1）ES6。（2）关于this的一道题。
2018-03-17 22:24:47 +08:00
modify
2018-03-17 12:10:41 +08:00
Reference in New Issue Copy Permalink