projectTips .gitignore失效、jest,superTest、src_refspec_not_match_any

summary_2018/06 think git npm

1、日常工作

• 1、提交Facbook广告花费和action获取服务
• 2、HTTP测试框架SuperTest、Jest

2、技术学习

• git_bug
  
  • .gitignore规则失效
    
    • “如果一个文件一开始没有添加到.gitignore里面，中途添加进去。git将不会忽略这个文件。”在这种情况下，必须使用git rm --cached 这个命令来移除对这个文件的跟踪，然后将这个不想被跟踪的文件添加到.gitignore文件里面就可以了。
  • src refspec xxx does not match any
    
    • 方案一：重新commit，再次push
    • 方案二：分支名错误
    • 方案三：

git push origin HEAD：master 
或者
git push origin“your_git_repo”：“your_branch_name”
或者
git push origin master - force

• SuperTest
  
  • 测试模块(node内嵌)
    
    • describe块称为"测试套件"（test suite），表示一组相关的测试。它是一个函数，第一个参数是测试套件的名称（"加法函数的测试"），第二个参数是一个实际执行的函数。
    • it/test块称为"测试用例"（test case），表示一个单独的测试，是测试的最小单位。它也是一个函数，第一个参数是测试用例的名称（"1 加 1 应该等于 2"），第二个参数是一个实际执行的函数
• install:npm install supertest --save-dev(-dev 放在开发所需要的模块)
• without using any test framework

const request = require('supertest');
const express = require('express');
//获取app实例
const app = express();
app.get('/user', function(req, res) {
  res.status(200).json({ name: 'john' });
});
//agent=request(app)
const agent=request.agent(app)
test('test',()=>{
  agent.get('/user')
    .expect('Content-Type', /json/)
    .expect('Content-Length', '15')
    .expect()
    .end(function(err, res) {
      if (err) throw err;
    });
})

• .end 处理assertions产生的错误
  
  • If you are using the .end() method .expect() assertions that fail will not throw - they will return the assertion as an error to the .end() callback. I

describe('POST /users', function() {
  it('responds with json', function(done) {
    request(app)
      .post('/users')
      .send({name: 'john'})
      .set('Accept', 'application/json')
      .expect(200)
      .end(function(err, res) {
        if (err) return done(err);
        //done()结束嵌套的回调函数，一个测试用例只能调用一次
        done();
      });
  });
});

• you can modify the response body or headers before executing an assertion.(在断言之前可以修改响应的header and body)

describe('POST /user', function() {
  it('user.name should be an case-insensitive match for "john"', function(done) {
    request(app)
      .post('/user')
      .send('name=john') // x-www-form-urlencoded upload
      .set('Accept', 'application/json')
      .expect(function(res) {
        res.body.id = 'some fixed id';
        res.body.name = res.body.name.toUpperCase();
      })
      .expect(200, {
        id: 'some fixed id',
        name: 'john'
      }, done);
  });
});

• how to persist a request and its cookies(保留cookie并发送)

  const agent = request.agent(app);
  it('should save cookies', function(done) {
    agent
    .get('/')
    .expect('set-cookie', 'cookie=hey; Path=/', done);
  });
  it('should send cookies', function(done) {
    agent
    .get('/return')
    .expect('hey', done);
  });

• 常用API

.expect(status[, fn])
Assert response status code.
.expect(status, body[, fn])
Assert response status code and body.
.expect(body[, fn])
Assert response body text with a string, regular expression, or parsed body object.
.expect(field, value[, fn])
Assert header field value with a string or regular expression.
.expect(function(res) {})
Pass a custom assertion function. It'll be given the response object to check. If the check fails, throw an error.
.end(fn)
Perform the request and invoke fn(err, res).

• jest
  
  • install:npm install --save-dev jest
  • expectAPI
    
    • expect(expect的参数应该是您的代码产生的值，匹配器的任何参数应该是正确的值)
      test('the best flavor is grapefruit', () => {
      expect(bestLaCroixFlavor()).toBe('grapefruit');
      });
    • expect.extend(matchers)（构建自定义的匹配器，expect.extends also supports async matchers）
    • expect.assertions(number)（ verifies that a certain number of assertions are called during a test. ）
    • expect.anything()（expect.anything() matches anything but null or undefined. ）
    • expect.any(constructor)
    • not（expect(bestLaCroixFlavor()).not.toBe('coconut')）
    • resolves（ return expect(Promise.resolve('lemon')).resolves.toBe('lemon')）
    • rejects
    • toBe(value)
    • toHaveBeenCalled()（ensure function got called.）
    • toEqual(value)(the same value)
    • toStrictEqual(value)(the same types as well as structure.)=toBe
  • Testing Asynchronous Code

/ Don't do this!
test('the data is peanut butter', () => {
  function callback(data) {
    expect(data).toBe('peanut butter');
  }
  fetchData(callback);
});
默认情况下，一旦Jest测试到达执行结束，它就会完成测试。但是问题是测试会在fetchData完成之前立即完成，然后再调用回调，不会按预期进行回调。

• 解决方案一：done
• 解决方案二：promise
• 解决方案三async/awit
• Setup and Teardown(一些每次测试前/后需要完成的工作)
  
  • 测试文件的执行顺序（normalcode->describe->test）
  • 作用域（describe/和整个测试文件）
• Mock(模拟)

3、思考与总结

• 实际项目中的一些思考
  
  • 对于一些脚本语言而言，代码末尾最好以空行结尾，可以避免一些意想不到的错误，比如PHP、NODE
  • Readme.md文档过长可以进行适当的拆分，比如拆分API，再进行引用（readme.md:deploy guid+dev guid）
  • 对于一些变量的配置，能采有注入的方式就注入，可以增加应用的灵活性，而不是写死在代码中
  • npm install时对于开发中需要的依赖，安装在dev中npm install --save-dev xx
• 对测试整体进行了一个初步的整体了解，还需进一步了解jest异步，SetupandTeardown，mock，和一些常见API的用法,还有Mocha,tap等